Update-VivaModuleFeaturePolicy
このコマンドレットは、Exchange Online PowerShell モジュール v3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
注: このコマンドレットは、現在閉じられたプライベート プレビューにある機能の一部です。 organizationがプライベート プレビューのメンバーでない限り、コマンドレットは機能しません。
Update-VivaModuleFeaturePolicy コマンドレットを使用して、Viva モジュールの機能のアクセス ポリシーを更新します。 特定のユーザーまたはグループの最も制限の厳しいポリシーは、機能が有効かどうかを判断するときに優先されます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-IsFeatureEnabled <Boolean>]
[-GroupIds <String[]>]
[-Everyone <Boolean>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] 説明
Update-VivaModuleFeaturePolicy コマンドレットを使用して、Viva モジュールの機能のアクセス ポリシーを更新します。
このコマンドレットは、指定したポリシーの属性を更新します。 これらの属性は次のとおりです。
- ポリシー名 (Name パラメーター)。
- ポリシーが機能を有効にするかどうか (IsFeatureEnabled パラメーター)。
- ポリシーが適用されるユーザー (UserIds パラメーターと GroupIds パラメーターまたは Everyone パラメーター)。
これらの属性は、相互に独立して更新できます。 たとえば、IsFeatureEnabled パラメーターではなく Name パラメーターを指定した場合、ポリシーの名前は更新されますが、ポリシーが機能を有効にするかどうかは変更されません。
重要: UserIds パラメーターまたは GroupIds パラメーターまたは Everyone パラメーターに指定した値は、既存のユーザーまたはグループを 上書き します。 既存のユーザーとグループを保持するには、既存のユーザーまたはグループ 、および 追加する追加のユーザーまたはグループを指定する必要があります。 コマンドに既存のユーザーまたはグループを含めないようにすると、これらの特定のユーザーまたはグループがポリシーから効果的に削除されます。 詳細については、例を参照してください。
認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
現時点では、このコマンドレットを実行するには、グローバル管理者ロールのメンバーである必要があります。
Azure Active Directory での管理者ロールのアクセス許可の詳細については、「 ロール テンプレート ID」を参照してください。
例
例 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false次の使用例は、指定したポリシーの名前を更新し、ポリシーが機能を有効にしないようにします。
例 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com次の使用例は、指定したポリシーが適用されるユーザーを更新します。 これで、ポリシーは指定したグループ にのみ 適用され、適用に使用されたユーザーとグループが上書きされます。
例 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com次の使用例は、指定したポリシーが適用されるユーザーを更新します。 これで、ポリシーは指定されたユーザー にのみ 適用され、適用に使用されたユーザーとグループが上書きされます。
例 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com -UserIds user1@contoso.com次の使用例は、指定したポリシーの名前を更新し、ポリシーで機能を有効にし、ポリシーが適用されるユーザーを更新します。 これで、ポリシーは指定したユーザーとグループ にのみ 適用され、適用に使用されたユーザーとグループが上書きされます。
パラメーター
-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
Everyone パラメーターは、更新されたポリシーがorganization内のすべてのユーザーに適用されることを指定します。 有効な値は次のとおりです。
- $true: ポリシーはすべてのユーザーに適用されます。 これは、このパラメーターに役立つ唯一の値です。
- $false: この値は使用しないでください。
ポリシーが適用されるユーザーを更新しない場合は、このパラメーターを使用しないでください。
GroupIds パラメーターまたは UserIds パラメーターでは、このパラメーターを使用しないでください。
| Type: | Boolean |
| 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 パラメーターは、更新されたポリシーが適用されるグループのメール アドレスを指定します。 メールが有効な AAD グループ がサポートされています。 Update
ポリシーが適用されるユーザーを更新しない場合は、このパラメーターを使用しないでください。
このパラメーターまたは UserIds パラメーターに指定した値は、既存のグループに置き換えられます。 既存のグループを保持するには、指定した新しいユーザーまたはグループと共にそれらを含めます。
最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。
更新されたポリシーをorganizationのすべてのユーザーに適用するには、値$trueで Everyone パラメーターを使用します。
| 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: | False |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyId
PolicyId パラメーターは、更新する Viva モジュールの機能のポリシーを指定します。
Viva モジュールの機能のポリシーの詳細を表示するには、Get-VivaModuleFeaturePolicy コマンドレットを使用します。 PolicyId 値は、コマンドレットの出力で返されます。
| 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
ポリシーが適用されるユーザーを更新しない場合は、このパラメーターを使用しないでください。
このパラメーターまたは GroupIds パラメーターに指定した値は、既存のユーザーを置き換えます。 既存のユーザーを保持するには、指定した新しいユーザーまたはグループと共にそれらを含めます。
最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。
更新されたポリシーをorganizationのすべてのユーザーに適用するには、値$trueで Everyone パラメーターを使用します。
| 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 |