Update-VivaModuleFeaturePolicy
このコマンドレットは、Exchange Online PowerShell モジュール バージョン 3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
Update-VivaModuleFeaturePolicy コマンドレットを使用して、Viva の Viva モジュール内の機能のアクセス ポリシーを更新します。
- 特定のユーザーまたはグループのポリシーを更新して、その機能に対してテナント全体を含めることはできません。 テナント全体のポリシーは 1 つだけサポートされます。
- 機能が有効になっているかどうかを判断する際は、特定のユーザーまたはグループに割り当てられたポリシーが、テナント全体に割り当てられているポリシーよりも優先されます。 ユーザーが機能に複数のポリシーを割り当てている場合 (ユーザーまたはグループのメンバーとして直接)、最も制限の厳しいポリシーが適用されます。
- 一部の機能では、特定のユーザーやグループではなく、テナント全体に適用されるポリシーのみがサポートされます。 Get-VivaModuleFeature コマンドレットを使用して、機能でサポートされているポリシー スコープを参照できます。
一部の機能には、ユーザー コントロール (ユーザー オプトアウト) のオプションが含まれます。 ポリシーを設定する機能でユーザー コントロールが使用できるかどうかを確認するには、機能のドキュメントを参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
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 Skillsの ShowAISkills 機能のポリシーを更新します。 このポリシーは、以前にポリシーに追加されたユーザーに対して機能を有効にし、ユーザー コントロールを許可し、既定でユーザーをオプトアウトします (ソフト無効化ポリシー)。
パラメーター
-Confirm
適用対象: Exchange Online
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Everyone
適用対象: Exchange Online
Everyone パラメーターは、更新されたポリシーが organization 内のすべてのユーザーに適用されることを指定します。 有効な値は次のとおりです。
- $true: ポリシーはすべてのユーザーに適用されます。 これは、このパラメーターの唯一の有用な値です。
- $false: この値は使用しないでください。
ポリシーの適用先を更新したくない場合は、このパラメーターを使用しないでください。
このパラメーターを GroupIds または UserIds パラメーターと共に使用しないでください。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FeatureId
適用対象: Exchange Online
FeatureId パラメーターは、更新するポリシーの Viva モジュールの機能を指定します。
機能アクセス制御をサポートする Viva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを使用します。 FeatureId 値はコマンドレットの出力で返されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-GroupIds
適用対象: Exchange Online
GroupIds パラメーターは、更新されたポリシーが適用されるグループのメール アドレスまたはセキュリティ グループ オブジェクト ID (GUID) を指定します。 メールが有効なMicrosoft Entra グループとメールが有効でない グループの両方がサポートされています。 Update
ポリシーの適用先を更新したくない場合は、このパラメーターを使用しないでください。
このパラメーターまたは UserIds パラメーターに指定した値によって、既存のグループが置き換えられます。 既存のグループを保持するには、指定した新しいユーザーまたはグループと一緒にグループを含めます。
合計 20 人のユーザーまたはグループ (20 人のユーザーでグループなし、10 人のユーザーと 10 人のグループなど) を指定できます。
更新されたポリシーをorganization内のすべてのユーザーに適用するには、Everyone パラメーターを値 $true と共に使用します。
注: モジュールの v3.5.1-Preview2 以降では、このパラメーターはセキュリティ グループ オブジェクト ID (GUID) をサポートします。 以前のバージョンのモジュールは、このパラメーターに電子メール アドレスのみを受け入れます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IsFeatureEnabled
適用対象: Exchange Online
IsFeatureEnabled パラメーターは、更新されたポリシーによって機能を有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 機能はポリシーによって有効化されています。
- $false: この機能はポリシーによって有効になっていません。
機能がポリシーによって有効になっているかどうかを更新しない場合は、このパラメーターを使用しないでください。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IsUserControlEnabled
適用対象: Exchange Online
注: このパラメーターは、モジュール バージョン 3.3.0-Preview1 以降で使用できます。 この機能でオプトアウトのユーザー コントロールがサポートされている場合は、ポリシーの作成時に必ず IsUserControlEnabled パラメーターを設定してください。 それ以外の場合、ポリシーのユーザー コントロールは機能の既定の状態を使用します。
IsUserControlEnabled パラメーターは、ユーザー制御がポリシーによって有効になっているかどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザー制御はポリシーによって有効化されています。 ユーザーはこの機能をオプトアウトできます。
- $false: ユーザー制御はポリシーで有効になっていません。 ユーザーはこの機能を選択できます。
管理者がポリシーによってユーザー コントロールを有効または無効にできる機能のみが、このパラメーターを使用できます。 この機能が管理者によるユーザー コントロールの切り替えをサポートしていない場合は、既定値が適用されます。 詳細については、機能のドキュメントを参照してください。
ユーザー コントロールがポリシーによって有効になっているかどうかを更新しない場合は、このパラメーターを使用しないでください。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IsUserOptedInByDefault
適用対象: Exchange Online
注: このパラメーターは、モジュール バージョン 3.8.0-Preview2 以降で使用できます。
IsUserOptedInByDefault パラメーターは、ユーザーがポリシーによって既定でオプトインされているかどうかを指定します。 有効な値は次のとおりです。
- $true: 既定では、ユーザーが設定を設定していない場合、ユーザーはポリシーによってオプトインされます。
- $false: 既定では、ユーザーが設定を設定していない場合、ユーザーはポリシーによってオプトアウトされます。
このパラメーターはオプションであり、機能メタデータで設定されている既定のユーザー オプトイン値をオーバーライドするために使用できます。
このパラメーターは、IsUserControlEnabled パラメーターが $true に設定されている場合にのみ設定できます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ModuleId
適用対象: Exchange Online
ModuleId パラメーターは、更新するポリシーの Viva モジュールを指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Online
Name パラメーターは、ポリシーの更新された名前を指定します。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
有効な文字は、英字、数字、コンマ、ピリオド、スペースです。
ポリシーの名前を更新しない場合は、このパラメーターを使用しないでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PolicyId
適用対象: Exchange Online
PolicyId パラメーターは、更新する Viva モジュール内の機能のポリシーを指定します。
Viva モジュールの機能のポリシーの詳細を表示するには、Get-VivaModuleFeaturePolicy コマンドレットを使用します。 PolicyId 値はコマンドレットの出力で返されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserIds
適用対象: Exchange Online
UserIds パラメーターは、更新されたポリシーが適用されるユーザーのユーザー プリンシパル名 (UPN) を指定します。 Update
ポリシーの適用先を更新したくない場合は、このパラメーターを使用しないでください。
このパラメーターまたは GroupIds パラメーターに指定した値によって、既存のユーザーが置き換えられます。 既存のユーザーを保持するには、指定した新しいユーザーまたはグループと一緒にそのユーザーを含めます。
合計 20 人のユーザーまたはグループ (20 人のユーザーでグループなし、10 人のユーザーと 10 人のグループなど) を指定できます。
更新されたポリシーをorganization内のすべてのユーザーに適用するには、Everyone パラメーターを値 $true と共に使用します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Online
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。