次の方法で共有


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