Add-VivaModuleFeaturePolicy

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

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

このコマンドレットには一時停止が組み込まれているため、 -Confirm:$false を使用して確認をスキップします。

[すべてのユーザー] スイッチは、ポリシーがorganization内のすべてのユーザーに適用されることを指定します。 このスイッチで値を指定する必要はありません。

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

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

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

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

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

organization内のすべてのユーザーにポリシーを適用するには、[すべてのユーザー] スイッチを使用します。

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

IsFeatureEnabled パラメーターは、この機能がポリシーによって有効になっているかどうかを指定します。 有効な値は次のとおりです。

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

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

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

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

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

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

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

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

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

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

ModuleId パラメーターは、機能ポリシーを追加するViva モジュールを指定します。

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

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

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

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

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

organization内のすべてのユーザーにポリシーを適用するには、[すべてのユーザー] スイッチを使用します。

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