New-FeatureConfiguration
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
注:
このコマンドレットは現在、パブリック プレビューで使用でき、すべての組織で使用できるわけではありません。変更される可能性があります。
New-FeatureConfiguration コマンドレットを使用して、organization内に次のような Microsoft Purview 機能構成を作成します。
- コレクション ポリシー。
- 高度なラベル ベースの保護。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-FeatureConfiguration
[-Name] <String>
-Mode <PolicyMode>
-FeatureScenario <PolicyScenario>
-ScenarioConfig <String>
[-Comment <String>]
[-Confirm]
[-Locations <String>]
[-WhatIf]
[<CommonParameters>] 説明
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「 セキュリティ & コンプライアンスのアクセス許可」を参照してください。
例
例 1
New-FeatureConfiguration -Name "Collection policy for supported Copilots" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText","DownloadText"],"EnforcementPlanes":["CopilotExperiences","Browser"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":true}' -Locations '[{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]},{"Workload":"Applications","Location":"49baeafd-1a6b-4c58-be55-75ae6d1dff6a","LocationSource":"PurviewConfig","LocationType":"Group","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]}]'この例では、"サポートされている Copilots のコレクション ポリシー" という名前の有効なコレクション ポリシーを作成します。
- サポートされているすべての分類子に UploadText & DownloadText アクティビティを含める
- すべての AI プロンプトをキャプチャします
- Microsoft Copilot & Copilot エクスペリエンスの場所が含まれます。どちらも、すべてのユーザー & グループにスコープが設定されています
例 2
New-FeatureConfiguration -Name "Scoped browser collection policy for Microsoft Copilot" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText"],"EnforcementPlanes":["Browser"],"SensitiveTypeIds":["All"],"ExcludedSensitiveTypeIds":["50b8b56b-4ef8-44c2-a924-03374f5831ce","8548332d-6d71-41f8-97db-cc3b5fa544e6"],"IsIngestionEnabled":false}' -Locations '[{"Workload":"Applications","Location":"52655","LocationDisplayName":null,"LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}],"Exclusions":[{"Type":"Group","Identity":"db458ddb-4f56-4d88-a4f7-e29545560839","DisplayName":"Contoso Executives","Name":"Executives@contoso.com"}]}]'次の使用例は、"Microsoft Copilotのスコープ付きブラウザー コレクション ポリシー" という名前の有効なコレクション ポリシーを作成します。
- "すべてのフル ネーム" と "すべての物理アドレス" を除く、サポートされているすべての分類子の UploadText アクティビティが含まれます
- "Contoso エグゼクティブ グループ" を除くすべてのユーザー & グループのMicrosoft Copilot場所が含まれます
例 3
New-FeatureConfiguration -Name "Scoped collection policies for browser and devices" -FeatureScenario KnowYourData -Mode Disable -ScenarioConfig '{"Activities":["UploadText","filecreated","filedeleted","filemodified"],"EnforcementPlanes":["Devices","Browser"],"SensitiveTypeIds":["a44669fe-0d48-453d-a9b1-2cc83f2cba77","cb353f78-2b72-4c3c-8827-92ebe4f69fdf"],"FileExtensions":["pdf"],"IsIngestionEnabled":false}' -Locations '[{"Workload":"EndpointDevices","Location":"","Inclusions":[{"Type":"Group","Identity":"db458ddb-4f56-4d88-a4f7-e29545560839","DisplayName":"All Company","Name":"allcompany@contoso.com"}],"Exclusions":[{"Type":"IndividualResource","Identity":"a828f25a-cede-4d0e-97e6-b0b0c913732a","DisplayName":"Alex Wilber","Name":"alex@contoso.com"}]},{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"IndividualResource","Identity":"84f9af2e-b224-4cb8-b9cd-bc531bb07a48","DisplayName":"Adele Vance","Name":"adele@contoso.com"}]}]'この例では、"ブラウザーとデバイスのスコープコレクション ポリシー" という名前の無効なコレクション ポリシーを作成します。
- UploadText (ブラウザー用) とファイル作成、ファイルデレット、ファイル変更されたアクティビティ (デバイス用) が含まれます
- "米国社会保障番号 (SSN)" および "ABA ルーティング番号" 分類子のみが含まれます
- "pdf" ファイル拡張子のみを持つデバイス上のファイルを検出します
- ユーザー "Alex Wilber" を除き、"すべての会社" グループを対象にしたデバイスの場所が含まれます
- Microsoft Copilotの場所が含まれます。スコープはユーザー "Adele Vance" のみです
パラメーター
-Comment
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-FeatureScenario
FeatureScenario パラメーターは、機能構成のシナリオを指定します。 現在、有効な値は次のとおりです。
-
KnowYourDataコレクション ポリシーの場合 -
TrustContainerエンドポイント DLP 信頼コンテナーの場合
| 型: | PolicyScenario |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-Locations
locations パラメーターは、機能構成が適用される場所を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-Mode
Mode パラメーターは、機能構成モードを指定します。 有効な値は次のとおりです。
- 有効: 機能の構成が有効になっています。
- 無効: 機能の構成が無効になっています。
| 型: | PolicyMode |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-Name
Name パラメーターは、機能構成の一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-ScenarioConfig
ScenarioConfig パラメーターは、機能構成に関する追加情報を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
| 適用対象: | Security & Compliance |