次の方法で共有

Update-VivaModuleFeaturePolicy

モジュール:
ExchangePowerShell
適用対象:
Exchange Online

このコマンドレットは、Exchange Online PowerShell モジュール v3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。

Update-VivaModuleFeaturePolicy コマンドレットを使用して、VivaのViva モジュールの機能のアクセス ポリシーを更新します。

  • テナント全体のポリシーが機能に既に存在する場合は、特定のユーザーまたはグループのポリシーを更新してテナント全体を含めることはできません。 サポートされているテナント全体のポリシーは 1 つだけです。
  • 特定のユーザーまたはグループに割り当てられたポリシーは、機能が有効かどうかを判断するときに、テナント全体に割り当てられたポリシーよりも優先されます。 ユーザーに機能に対して複数のポリシーが割り当てられている場合 (グループのユーザーまたはメンバーとして直接)、最も制限の厳しいポリシーが適用されます。
  • 一部の機能では、特定のユーザーやグループではなく、テナント全体に適用されるポリシーのみがサポートされます。 Get-VivaModuleFeature コマンドレットを使用して、機能のサポートされているポリシー スコープを参照できます。

一部の機能には、ユーザー コントロールのオプション (ユーザーのオプトアウト) が含まれます。 ポリシーを設定する機能に対してユーザー コントロールを使用できるかどうかを確認するには、機能ドキュメントを参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Update-VivaModuleFeaturePolicy
      -FeatureId <String>
      -ModuleId <String>
      -PolicyId <String>
      [-Confirm]
      [-Everyone <Boolean>]
      [-IsFeatureEnabled <Boolean>]
      [-IsUserControlEnabled <Boolean>]
      [-IsUserOptedInByDefault <Boolean>]
      [-GroupIds <String[]>]
      [-Name <String>]
      [-ResultSize <Unlimited>]
      [-UserIds <String[]>]
      [-WhatIf]
      [<CommonParameters>]

説明

Update-VivaModuleFeaturePolicy コマンドレットを使用して、VivaのViva モジュールの機能のアクセス ポリシーを更新します。

このコマンドレットは、指定したポリシーの属性を更新します。 これらの属性は次のとおりです。

  • ポリシー名 (Name パラメーター)。
  • ポリシーが機能を有効にするかどうか (IsFeatureEnabled パラメーター)。
  • ポリシーでユーザー制御を有効にするかどうか (IsUserControlEnabled パラメーター、機能ポリシーにのみ適用されます)。
  • ポリシーが適用されるユーザー (UserIds パラメーターと GroupIds パラメーターまたは Everyone パラメーター)。

これらの属性は、相互に独立して更新できます。 たとえば、IsFeatureEnabled パラメーターではなく Name パラメーターを指定した場合、ポリシーの名前は更新されますが、ポリシーが機能を有効にするかどうかは変更されません。

重要: UserIds パラメーターまたは GroupIds パラメーターまたは Everyone パラメーターに指定した値は、既存のユーザーまたはグループを 上書き します。 既存のユーザーとグループを保持するには、既存のユーザーまたはグループ 、および 追加する追加のユーザーまたはグループを指定する必要があります。 コマンドに既存のユーザーまたはグループを含めないようにすると、これらの特定のユーザーまたはグループがポリシーから効果的に削除されます。 詳細については、例を参照してください。

認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。

このコマンドレットには、.NET Framework 4.7.2 以降が必要です。

現時点では、このコマンドレットを実行するには、グローバル管理者ロールのメンバーであるか、機能レベルで割り当てられているロールである必要があります。

機能レベルで割り当てられたロールの詳細については、「 機能アクセス管理で使用できる機能」を参照してください。

Microsoft Entra IDでの管理者ロールのアクセス許可の詳細については、「ロール テンプレート ID」を参照してください。

重要

Microsoft では、アクセス許可が可能な限りで少ないロールを使用することをお勧めします。 アクセス許可の低いアカウントを使用すると、組織のセキュリティが向上します。 グローバル管理者は高い特権を持つロールであり、既存のロールを使用できない場合の緊急時に限定する必要があります。

例

例 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,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com

次の使用例は、指定したポリシーの名前を更新し、ポリシーで機能を有効にし、ポリシーが適用されるユーザーを更新します。 これで、ポリシーは指定したユーザーとグループ にのみ 適用され、適用に使用されたユーザーとグループが上書きされます。

例 5

Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false

次の使用例は、Viva スキルの ShowAISkills 機能のポリシーを更新します。 ポリシーにより、以前にポリシーに追加されたユーザーの機能が有効になり、ユーザー制御が許可され、既定でユーザーがオプトアウトされます (論理的な無効化ポリシー)。

パラメーター

-Confirm

適用対象: Exchange Online

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Everyone

適用対象: Exchange Online

Everyone パラメーターは、更新されたポリシーがorganization内のすべてのユーザーに適用されることを指定します。 有効な値は次のとおりです。

  • $true: ポリシーはすべてのユーザーに適用されます。 これは、このパラメーターに役立つ唯一の値です。
  • $false: この値は使用しないでください。

ポリシーが適用されるユーザーを更新しない場合は、このパラメーターを使用しないでください。

GroupIds パラメーターまたは UserIds パラメーターでは、このパラメーターを使用しないでください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FeatureId

適用対象: Exchange Online

FeatureId パラメーターは、更新するポリシーの Viva モジュールの機能を指定します。

機能アクセス制御をサポートするViva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを使用します。 FeatureId 値は、コマンドレットの出力で返されます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-GroupIds

適用対象: Exchange Online

GroupIds パラメーターは、更新されたポリシーが適用されるグループのメール アドレスまたはセキュリティ グループ オブジェクト ID (GUID) を指定します。 メールが有効なグループとメールが有効でないMicrosoft Entra グループの両方がサポートされています。 Update

ポリシーが適用されるユーザーを更新しない場合は、このパラメーターを使用しないでください。

このパラメーターまたは UserIds パラメーターに指定した値は、既存のグループに置き換えられます。 既存のグループを保持するには、指定した新しいユーザーまたはグループと共にそれらを含めます。

最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。

更新されたポリシーをorganizationのすべてのユーザーに適用するには、値$trueで Everyone パラメーターを使用します。

注: モジュールの v3.5.1-Preview2 以降では、このパラメーターはセキュリティ グループ オブジェクト ID (GUID) をサポートします。 モジュールの以前のバージョンでは、このパラメーターの電子メール アドレスのみを受け入れます。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IsFeatureEnabled

適用対象: Exchange Online

IsFeatureEnabled パラメーターは、更新されたポリシーで機能を有効にするかどうかを指定します。 有効な値は次のとおりです。

  • $true: この機能はポリシーによって有効になっています。
  • $false: この機能はポリシーによって有効になっていません。

機能がポリシーによって有効になっているかどうかを更新しない場合は、このパラメーターを使用しないでください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IsUserControlEnabled

適用対象: Exchange Online

注: このパラメーターは、モジュールのバージョン 3.3.0 以降で使用できます。 この機能でオプトアウトのユーザー コントロールがサポートされている場合は、ポリシーの作成時に IsUserControlEnabled パラメーターを設定してください。 それ以外の場合、ポリシーのユーザー コントロールでは、機能の既定の状態が使用されます。

IsUserControlEnabled パラメーターは、ユーザー コントロールがポリシーによって有効かどうかを指定します。 有効な値は次のとおりです。

  • $true: ユーザー制御はポリシーによって有効になります。 ユーザーは、この機能をオプトアウトできます。
  • $false: ユーザー コントロールがポリシーで有効になっていません。 ユーザーは、この機能を選択できません。

管理者がポリシーによってユーザー制御を有効または無効にできる機能のみが、このパラメーターを使用できます。 この機能で管理者がユーザー コントロールの切り替えをサポートしていない場合、既定値が適用されます。 詳細については、機能ドキュメントを参照してください。

ユーザー コントロールがポリシーによって有効になっているかどうかを更新しない場合は、このパラメーターを使用しないでください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IsUserOptedInByDefault

適用対象: Exchange Online

このパラメーターは、モジュールのバージョン 3.8.0-Preview2 以降で使用できます。

IsUserOptedInByDefault パラメーターは、ポリシーによってユーザーが既定でオプトインされるかどうかを指定します。 有効な値は次のとおりです。

  • $true: 既定では、ユーザーが基本設定を設定していない場合、ユーザーはポリシーによってオプトインされます。
  • $false: 既定では、ユーザーが基本設定を設定していない場合、ユーザーはポリシーによってオプトアウトされます。

このパラメーターは省略可能であり、機能メタデータに設定されている既定のユーザーオプトイン値をオーバーライドするために使用できます。

このパラメーターは、IsUserControlEnabled パラメーターが $true に設定されている場合にのみ設定できます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ModuleId

適用対象: Exchange Online

ModuleId パラメーターは、更新するポリシーのViva モジュールを指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

適用対象: Exchange Online

Name パラメーターは、ポリシーの更新された名前を指定します。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

有効な文字は、英語の文字、数字、コンマ、ピリオド、スペースです。

ポリシーの名前を更新しない場合は、このパラメーターを使用しないでください。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PolicyId

適用対象: Exchange Online

PolicyId パラメーターは、更新するViva モジュールの機能のポリシーを指定します。

Viva モジュールの機能のポリシーの詳細を表示するには、Get-VivaModuleFeaturePolicy コマンドレットを使用します。 PolicyId 値は、コマンドレットの出力で返されます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResultSize

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

型:Unlimited
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserIds

適用対象: Exchange Online

UserIds パラメーターは、更新されたポリシーが適用されるユーザーのユーザー プリンシパル名 (UPN) を指定します。 Update

ポリシーが適用されるユーザーを更新しない場合は、このパラメーターを使用しないでください。

このパラメーターまたは GroupIds パラメーターに指定した値は、既存のユーザーを置き換えます。 既存のユーザーを保持するには、指定した新しいユーザーまたはグループと共にそれらを含めます。

最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。

更新されたポリシーをorganizationのすべてのユーザーに適用するには、値$trueで Everyone パラメーターを使用します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

適用対象: Exchange Online

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False