Get-VivaModuleFeaturePolicy
このコマンドレットは、Exchange Online PowerShell モジュール バージョン 3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
Get-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の Viva モジュールで指定された機能のアクセス ポリシーを表示します。 ポリシーは、特定のユーザー、グループ、またはテナント全体に対して、指定された機能へのアクセスを制限または許可するために使用されます。 このコマンドレットは、ポリシーの識別子、名前、作成日など、ポリシーに関する詳細を提供します。 このコマンドレットは、MemberIds に基づいてポリシーをフィルター処理できるため、管理者は特定のユーザーまたはグループに固有のポリシーを表示できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
FeaturePolicy
Get-VivaModuleFeaturePolicy
[[-PolicyId] <String>]
-FeatureId <String>
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
FeaturePolicyWithMembers
Get-VivaModuleFeaturePolicy
[[-FeatureId] <String>]
[[-MemberIds] <String[]>]
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
Get-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の Viva モジュールで指定された機能のアクセス ポリシーを表示します。
Viva の Viva モジュールで指定された機能のすべてのポリシーを表示できます。 特定のポリシーを表示するには、PolicyId パラメーターを含めることができます。
このコマンドレットは、MemberIds に基づいてポリシーをフィルター処理できるため、管理者は特定のユーザーまたはグループに固有のポリシーを表示できます。
認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
現在、このコマンドレットを実行するには、グローバル管理者ロール、または機能レベルで割り当てられているロールのメンバーである必要があります。
機能レベルで割り当てられたロールの詳細については、「 機能アクセス管理に使用できる機能」を参照してください。
Microsoft Entra ID の管理者ロールのアクセス許可の詳細については、「ロール テンプレートの ID」を参照してください。
重要
Microsoft では、最小限のアクセス許可の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、組織の全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常は緊急時や別のロールを使用できない場合に限定する、非常に特権のあるロールです。
例
例 1
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
この例では、Viva インサイトのリフレクション機能用に追加されたすべてのポリシーに関する詳細を返します。
例 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
この例では、Viva インサイトのリフレクション機能に追加された特定のポリシーに関する詳細を返します。
例 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
この例では、メールの user1@contoso.comを持つユーザーに適用される、Viva インサイトのリフレクション機能のポリシーに関する詳細を返します。
例 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
この例では、メール user1@contoso.com を持つユーザーとメール group1@contoso.comを持つグループに適用される、すべての Viva モジュールのすべての機能に関するポリシーの詳細を返します。
パラメーター
-FeatureId
適用対象: Exchange Online
FeatureId パラメーターは、ポリシーを表示する Viva モジュールの機能を指定します。
機能アクセス制御をサポートする Viva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを参照してください。 Get-VivaModuleFeature コマンドレットによって提供される詳細には、機能識別子が含まれます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FeaturePolicy
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
FeaturePolicyWithMembers
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MemberIds
適用対象: Exchange Online
注: このパラメーターは、モジュール バージョン 3.8.1-Preview1 以降で使用できます。
MemberIds パラメーターは、Viva モジュールの機能のポリシーを表示する特定のユーザーまたはグループを指定します。
メンバー ID は 3 つまで指定できます。 * 文字を使用して、すべてのモジュールまたは機能を指定します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FeaturePolicyWithMembers
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModuleId
適用対象: Exchange Online
ModuleId パラメーターは、表示する機能ポリシーの Viva モジュールを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PolicyId
適用対象: Exchange Online
PolicyId パラメーターは、表示する Viva モジュール内の機能の特定のポリシーを指定します。
Viva モジュール内の機能のすべてのポリシーの詳細を表示するには、PolicyId パラメーターなしでこのコマンドレットを実行します。 これらの詳細には、Viva モジュール内の機能のすべてのポリシーの識別子が含まれます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FeaturePolicy
| 配置: | Positional |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| 規定値: | 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」を参照してください。