Add-VivaModuleFeaturePolicy
このコマンドレットは、Exchange Online PowerShell モジュール v3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
注: このコマンドレットは、現在閉じられたプライベート プレビューにある機能の一部です。 organizationがプライベート プレビューのメンバーでない限り、コマンドレットは機能しません。
Add-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の特定の機能の新しいアクセス ポリシーを追加します。 ポリシーの属性は、コマンドレットのさまざまなパラメーターを使用して定義されます。 ポリシーは、特定のユーザー、グループ、またはテナント全体に対して、指定した機能へのアクセスを制限または許可するために使用されます。 特定のユーザーまたはグループの最も制限の厳しいポリシーは、機能が有効かどうかを判断するときに優先されることに注意してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>] 説明
Add-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の特定の機能の新しいアクセス ポリシーを追加します。
認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
現時点では、このコマンドレットを実行するには、グローバル管理者ロールのメンバーである必要があります。
Azure Active Directory での管理者ロールのアクセス許可の詳細については、「 ロール テンプレート ID」を参照してください。
例
例 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone次の使用例は、Viva Insightsのリフレクション機能のポリシーを追加します。 このポリシーでは、organization内のすべてのユーザーの機能が無効になります。
例 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com次の使用例は、Viva Insightsのリフレクション機能のポリシーを追加します。 このポリシーでは、指定したグループ内のすべてのユーザーの機能が無効になります。
例 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.com次の使用例は、Viva Insightsのリフレクション機能のポリシーを追加します。 このポリシーでは、指定したユーザーの機能が無効になります。
例 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com -UserIds user1@contoso.com,user2@contoso.com次の使用例は、Viva Insightsのリフレクション機能のポリシーを追加します。 このポリシーでは、指定したユーザーとグループ メンバーの機能が無効になります。
パラメーター
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
[すべてのユーザー] スイッチは、ポリシーがorganization内のすべてのユーザーに適用されることを指定します。 このスイッチで値を指定する必要はありません。
GroupIds パラメーターまたは UserIds パラメーターでは、このスイッチを使用しないでください。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
FeatureId パラメーターは、ポリシーを追加する Viva モジュールの機能を指定します。
機能アクセス制御をサポートする Viva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを使用します。 FeatureId 値は、コマンドレットの出力で返されます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
GroupIds パラメーターは、ポリシーが適用されるグループの SMTP アドレス (電子メール アドレス) を指定します。 メールが有効な AAD グループ がサポートされています。 Update
最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。
organization内のすべてのユーザーにポリシーを適用するには、[すべてのユーザー] スイッチを使用します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
IsFeatureEnabled パラメーターは、この機能がポリシーによって有効になっているかどうかを指定します。 有効な値は次のとおりです。
- $true: この機能はポリシーによって有効になっています。
- $false: この機能はポリシーによって有効になっていません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
ModuleId パラメーターは、機能ポリシーを追加する Viva モジュールを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Name パラメーターは、ポリシーの名前を指定します。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
有効な文字は、英語の文字、数字、コンマ、ピリオド、スペースです。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
UserIds パラメーターは、ポリシーが適用されるユーザーのユーザー プリンシパル名 (UPN) を指定します。 Update
最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。
organization内のすべてのユーザーにポリシーを適用するには、[すべてのユーザー] スイッチを使用します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |