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 では、最小限の特権の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、organizationの全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常、緊急シナリオや別のロールを使用できない場合に制限する高い特権を持つロールです。
例
例 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
Identity パラメーターは、ユーザーのユーザー プリンシパル名 (UPN) または機能有効化の状態を表示するグループの SMTP アドレス (電子メール アドレス) を指定します。
メールが有効なMicrosoft Entra グループがサポートされています。
パラメーターのプロパティ
| 型: | 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」を参照してください。