Add-VivaModuleFeaturePolicy
このコマンドレットは、Exchange Online PowerShell モジュール v3.2.0 以降でのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
注: カテゴリのサポートは、バージョン 3.5.0-Preview2 以降のモジュールで利用できますが、現在、Vivaで利用できるカテゴリはありません。 カテゴリが利用可能な場合は、ドキュメントを更新します。
Add-VivaModuleFeaturePolicy コマンドレットを使用して、特定の機能またはカテゴリの新しいアクセス ポリシーをVivaに追加します。 ポリシーの属性は、コマンドレット パラメーターを使用して定義されます。 ポリシーは、特定のユーザー、グループ、またはテナント全体に対して、指定した機能またはカテゴリへのアクセスを制限または許可するために使用されます。
- 機能/カテゴリごとに最大 10 個のポリシーを割り当てることができます。 機能/カテゴリごとに追加の 1 つのポリシーをテナント全体に割り当てることができます。
- 特定のユーザーまたはグループに割り当てられたポリシーは、機能/カテゴリが有効かどうかを判断するときに、テナント全体に割り当てられたポリシーよりも優先されます。 ユーザーに機能/カテゴリに複数のポリシーが割り当てられている場合 (グループのユーザーまたはメンバーとして直接)、最も制限の厳しいポリシーが適用されます。
- カテゴリ ポリシーによってカテゴリが無効になっている場合、カテゴリの下のすべての機能は、機能レベルで設定されたポリシーに関係なく無効になります。
- ユーザー コントロールは、カテゴリ ポリシー レベルではなく、機能ポリシー レベルでのみ更新できます。
- 一部の機能では、特定のユーザーやグループではなく、テナント全体に適用されるポリシーのみがサポートされます。 Get-VivaModuleFeature コマンドレットを使用して、機能のサポートされているポリシー スコープを参照できます。
一部の機能には、ユーザー コントロールのオプション (ユーザーのオプトアウト) が含まれます。 ポリシーを設定する機能に対してユーザー コントロールを使用できるかどうかを確認するには、機能ドキュメントを参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Add-VivaModuleFeaturePolicy
-CategoryId <String>
-IsCategoryEnabled <Boolean>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] 説明
Add-VivaModuleFeaturePolicy コマンドレットを使用して、Vivaの特定の機能またはカテゴリの新しいアクセス ポリシーを追加します。
カテゴリのサポートは、バージョン 3.5.0-Preview2 以降のモジュールで利用できます。
認証には、Connect-ExchangeOnline コマンドレットを使用する必要があります。
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
現時点では、このコマンドレットを実行するには、グローバル管理者ロールのメンバーであるか、機能レベルで割り当てられているロールである必要があります。
機能レベルで割り当てられたロールの詳細については、「 機能アクセス管理で使用できる機能」を参照してください。
Microsoft Entra IDでの管理者ロールのアクセス許可の詳細については、「ロール テンプレート ID」を参照してください。
重要
Microsoft では、アクセス許可が可能な限りで少ないロールを使用することをお勧めします。 アクセス許可の低いアカウントを使用すると、組織のセキュリティが向上します。 グローバル管理者は高い特権を持つロールであり、既存のロールを使用できない場合の緊急時に限定する必要があります。
例
例 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,57680382-61a5-4378-85ad-f72095d4e9c3次の使用例は、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,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.com次の使用例は、Viva Insightsのリフレクション機能のポリシーを追加します。 このポリシーでは、指定したユーザーとグループ メンバーの機能が無効になります。
例 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -Everyone次の使用例は、Vivaの<category_id> カテゴリのポリシーを追加します。 このポリシーでは、organization内のすべてのユーザーのカテゴリ (実質的にカテゴリのすべての機能) が無効になります。
例 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3次の使用例は、Vivaの<category_id> カテゴリのポリシーを追加します。 このポリシーでは、指定したグループ内のすべてのユーザーのカテゴリ (実質的にカテゴリのすべての機能) が無効になります。
例 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.com次の使用例は、Vivaの<category_id> カテゴリのポリシーを追加します。 ポリシーは、指定されたユーザーのカテゴリ (実質的にカテゴリの下のすべての機能) を無効にします。
例 8
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.com次の使用例は、Vivaの<category_id> カテゴリのポリシーを追加します。 ポリシーは、指定されたユーザーとグループ メンバーのカテゴリ (実質的にカテゴリの下のすべての機能) を無効にします。
例 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -Everyone次の使用例は、Vivaに<category_id> カテゴリのポリシーを追加します。このポリシー名にはスペースが付きます。 このポリシーでは、organization内のすべてのユーザーのカテゴリ (実質的にカテゴリのすべての機能) が無効になります。
パラメーター
-CategoryId
このパラメーターは、バージョン 3.5.0-Preview2 以降のモジュールで使用できます。
注: 現在、Vivaではカテゴリを使用できません。 カテゴリが利用可能な場合は、ドキュメントを更新します。
CategoryId パラメーターは、ポリシーを追加するVivaカテゴリを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
このコマンドレットには一時停止が組み込まれているため、 -Confirm:$false を使用して確認をスキップします。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-Everyone
[すべてのユーザー] スイッチは、ポリシーがorganization内のすべてのユーザーに適用されることを指定します。 このスイッチで値を指定する必要はありません。
GroupIds パラメーターまたは UserIds パラメーターでは、このスイッチを使用しないでください。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-FeatureId
FeatureId パラメーターは、ポリシーを追加するViva モジュールの機能を指定します。
機能アクセス制御をサポートするViva モジュールの機能の詳細を表示するには、Get-VivaModuleFeature コマンドレットを使用します。 FeatureId 値は、コマンドレットの出力で返されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-GroupIds
GroupIds パラメーターは、更新されたポリシーが適用されるグループのメール アドレスまたはセキュリティ グループ オブジェクト ID (GUID) を指定します。 メールが有効なグループとメールが有効でないMicrosoft Entra グループの両方がサポートされています。 Update
最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。
organization内のすべてのユーザーにポリシーを適用するには、[すべてのユーザー] スイッチを使用します。
注: モジュールの v3.5.1-Preview2 以降では、このパラメーターはセキュリティ グループ オブジェクト ID (GUID) をサポートします。 モジュールの以前のバージョンでは、このパラメーターの電子メール アドレスのみを受け入れます。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-IsCategoryEnabled
このパラメーターは、バージョン 3.5.0-Preview2 以降のモジュールで使用できます。
注: 現在、Vivaではカテゴリを使用できません。 カテゴリが利用可能な場合は、ドキュメントを更新します。
IsCategoryEnabled パラメーターは、カテゴリがポリシーによって有効かどうかを指定します。 有効な値は次のとおりです。
- $true: カテゴリはポリシーによって有効になります。
- $false: カテゴリがポリシーで有効になっていません。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-IsFeatureEnabled
IsFeatureEnabled パラメーターは、この機能がポリシーによって有効になっているかどうかを指定します。 有効な値は次のとおりです。
- $true: この機能はポリシーによって有効になっています。
- $false: この機能はポリシーによって有効になっていません。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-IsUserControlEnabled
このパラメーターは、モジュールのバージョン 3.3.0 以降で使用できます。
IsUserControlEnabled パラメーターは、ユーザー コントロールがポリシーによって有効かどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザー制御はポリシーによって有効になります。 ユーザーは、この機能をオプトアウトできます。
- $false: ユーザー コントロールがポリシーで有効になっていません。 ユーザーは、この機能を選択できません。
管理者がポリシーによってユーザー制御を有効または無効にできる機能のみが、このパラメーターを使用できます。 この機能で管理者がユーザー コントロールの切り替えをサポートしていない場合、既定値が適用されます。 詳細については、機能ドキュメントを参照してください。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-ModuleId
ModuleId パラメーターは、機能ポリシーを追加するViva モジュールを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-Name
Name パラメーターは、ポリシーの名前を指定します。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
有効な文字は、英語の文字、数字、コンマ、ピリオド、スペースです。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-ResultSize
このパラメーターは、Microsoft の内部使用のために予約されています。
| 型: | Unlimited |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-UserIds
UserIds パラメーターは、ポリシーが適用されるユーザーのユーザー プリンシパル名 (UPN) を指定します。 Update
最大 20 人の合計ユーザーまたはグループ (20 ユーザーとグループなし、10 ユーザーと 10 グループなど) を指定できます。
organization内のすべてのユーザーにポリシーを適用するには、[すべてのユーザー] スイッチを使用します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Exchange Online |