Get-VivaModuleFeatureEnablement
このコマンドレットは、Exchange Online PowerShell モジュール バージョン 3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
Get-VivaModuleFeatureEnablement コマンドレットを使用して、Viva モジュールの機能が特定のユーザーまたはグループに対して有効になっているかどうかを表示します。 機能が有効になっているかどうかは、機能の "有効化状態" と呼ばれます。 このコマンドレットによって返される有効化状態は、管理者によって設定されたアクセス ポリシーに基づいています。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
Get-VivaModuleFeatureEnablement コマンドレットを使用して、Viva モジュールの機能が特定のユーザーまたはグループに対して有効になっているかどうかを表示します。
認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
現在、このコマンドレットを実行するには、グローバル管理者ロールのメンバーである必要があります。
Microsoft Entra ID の管理者ロールのアクセス許可の詳細については、「ロール テンプレートの ID」を参照してください。
重要
Microsoft では、最小限のアクセス許可の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、組織の全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常は緊急時や別のロールを使用できない場合に限定する、非常に特権のあるロールです。
例
例 1
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
この例では、 user@contoso.com ユーザーに対して Viva Insights のリフレクション機能の有効化状態を返します。
例 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
この例では、 group@contoso.com グループの Viva Insights リフレクション機能の有効化状態を返します。
例 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
この例では、 user@contoso.com ユーザーに対して Viva Insights のリフレクション機能の有効化状態を返します。 応答が強化され、機能の有効化状態を駆動しているポリシーに関する追加情報が提供されるようになりました
パラメーター
-Detailed
適用対象: Exchange Online
注: このパラメーターは、モジュール バージョン 3.8.1-Preview1 以降で使用できます。
[詳細] スイッチは、より包括的な情報を提供することでコマンドの出力を強化します。 このスイッチで値を指定する必要はありません。
このスイッチは、関連するポリシーとその有効性を含む詳細な分析情報を返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FeatureId
適用対象: Exchange Online
FeatureId パラメーターは、Viva モジュールの機能を指定します。
機能アクセス制御をサポートする Viva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを参照してください。 Get-VivaModuleFeature コマンドレットによって提供される詳細には、機能識別子が含まれます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online
ID パラメーターは、ユーザーのユーザー プリンシパル名 (UPN) か、機能の有効化状態を表示するグループの SMTP アドレス (電子メール アドレス) を指定します。
メールが有効な Microsoft Entra グループがサポートされています。
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModuleId
適用対象: Exchange Online
ModuleId パラメーターは、Viva モジュールを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。