New-AutoSensitivityLabelPolicy
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ使用できます。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。
New-AutoSensitivityLabelPolicy コマンドレットを使用して、組織内に自動ラベル付けポリシーを作成します。 New-AutoSensitivityLabelRule コマンドレットを使用して自動ラベル付けポリシー 規則を作成し、ポリシーと関連付けてポリシーの作成を完了します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-AutoSensitivityLabelPolicy
[-Name] <String>
-ApplySensitivityLabel <String>
[-Comment <String>]
[-Confirm]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeSender <SmtpAddress[]>]
[-ExchangeSenderException <SmtpAddress[]>]
[-ExchangeSenderMemberOf <SmtpAddress[]>]
[-ExchangeSenderMemberOfException <SmtpAddress[]>]
[-ExternalMailRightsManagementOwner <SmtpAddress>]
[-Force]
[-Mode <PolicyMode>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-OverwriteLabel <Boolean>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PolicyTemplateInfo <PswsHashtable>]
[-Priority <System.Int32>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-UnifiedAuditLogEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
説明
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
New-AutoSensitivityLabelPolicy -Name "GlobalPolicy" -Comment "Primary policy" -SharePointLocation "https://my.url","https://my.url2" -OneDriveLocation "https://my.url3","https://my.url4" -Mode TestWithoutNotifications -ApplySensitivityLabel "Test"
次の使用例は、指定した SharePoint Online の GlobalPolicy という名前の自動ラベル付けポリシーを作成し、"Test" というラベルを持つ場所をOneDrive for Businessします。 新しいポリシーには説明的なコメントがあり、作成時にシミュレーション モードになります。
パラメーター
-ApplySensitivityLabel
ApplySensitivityLabel パラメーターは、自動ラベル付けポリシーに使用するラベルを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Comment
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeLocation
ExchangeLocation パラメーターは、ポリシーに電子メール メッセージを含めるかどうかを指定します。 このパラメーターの有効な値は All です。 ポリシーに電子メール メッセージを含めない場合は、このパラメーターを使用しないでください (既定値は空白または$null)。
このパラメーターは、次の手順で使用できます。
単独で使用
-ExchangeLocation All
する場合、ポリシーはすべての内部ユーザーの電子メールに適用されます。ポリシーに特定の内部ユーザーまたは外部ユーザーの電子メールを含める場合は、同じコマンドで ExchangeSender パラメーターを使用
-ExchangeLocation All
します。 指定したユーザーのメールのみがポリシーに含まれます。ポリシーに特定のグループ メンバーのメールのみを含める場合は、同じコマンドで ExchangeSenderMemberOf パラメーターと共に を使用
-ExchangeLocation All
します。 ポリシーには、指定したグループのメンバーの電子メールのみが含まれます。ポリシーから特定の内部ユーザーのメールを除外するには、同じコマンドで ExchangeSenderException パラメーターを使用
-ExchangeLocation All
します。 指定したユーザーのメールのみがポリシーから除外されます。ポリシーから特定のグループ メンバーのメールのみを除外するには、同じコマンドで ExchangeSenderMemberOfException パラメーターを使用
-ExchangeLocation All
します。 指定したグループのメンバーの電子メールのみがポリシーから除外されます。
同じポリシーに包含と除外を指定することはできません。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeSender
ExchangeSender パラメーターは、メールがポリシーに含まれているユーザーを指定します。 ユーザーを電子メール アドレスで識別します。 内部または外部のメール アドレスを指定できます。
複数の値を入力するには、次の構文を使用します。 <value1>,<value2>,...<valueX>
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "<value1>","<value2>",..."<valueX>"
このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。
ExchangeSenderException パラメーターまたは ExchangeSenderMemberOfException パラメーターでは、このパラメーターを使用できません。
Type: | SmtpAddress[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeSenderException
ExchangeSenderException パラメーターは、メールがポリシーから除外される内部ユーザーを指定します。 ユーザーを電子メール アドレスで識別します。
複数の値を入力するには、次の構文を使用します。 <value1>,<value2>,...<valueX>
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "<value1>","<value2>",..."<valueX>"
このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。
このパラメーターは、ExchangeSender パラメーターまたは ExchangeSenderMemberOf パラメーターでは使用できません。
Type: | SmtpAddress[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeSenderMemberOf
ExchangeSenderMemberOf パラメーターは、ポリシーに含める配布グループまたはメールが有効なセキュリティ グループを指定します (グループ メンバーの電子メールはポリシーに含まれます)。 グループは電子メール アドレスで識別します。
複数の値を入力するには、次の構文を使用します。 <value1>,<value2>,...<valueX>
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "<value1>","<value2>",..."<valueX>"
このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。
ExchangeSenderException パラメーターまたは ExchangeSenderMemberOfException パラメーターでは、このパラメーターを使用できません。
このパラメーターを使用してMicrosoft 365 グループを指定することはできません。
Type: | SmtpAddress[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeSenderMemberOfException
ExchangeSenderMemberOfException パラメーターは、ポリシーから除外する配布グループまたはメールが有効なセキュリティ グループを指定します (グループ メンバーの電子メールはポリシーから除外されます)。 グループは電子メール アドレスで識別します。
複数の値を入力するには、次の構文を使用します。 <value1>,<value2>,...<valueX>
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "<value1>","<value2>",..."<valueX>"
このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。
このパラメーターは、ExchangeSender パラメーターまたは ExchangeSenderMemberOf パラメーターでは使用できません。
このパラメーターを使用してMicrosoft 365 グループを指定することはできません。
Type: | SmtpAddress[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExternalMailRightsManagementOwner
ExternalMailRightsManagementOwner パラメーターは、RMS を使用して外部送信者からの受信電子メール メッセージを暗号化するために使用されるユーザー メールボックスのメール アドレスを指定します。
このパラメーターは Exchange の場所でのみ機能し、ポリシーは暗号化アクションを持つラベルを適用する必要があります。
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Force
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Mode
Mode パラメーターは、自動ラベル付けポリシーのアクションと通知レベルを指定します。 有効な値は次のとおりです。
- 有効: アクションと通知に対してポリシーが有効になっています。 これは既定の値です。
- Enable: ポリシーはアクションと通知に関して有効です。これが既定値です。
- Disable: ポリシーを無効にします。
- TestWithNotifications: アクションは実行されませんが、通知が送信されます。
Type: | PolicyMode |
Accepted values: | Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
Name パラメーターは、自動ラベル付けポリシーの一意の名前を指定します。 値にスペースが含まれている場合は、値を引用符 (") で囲みます。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocation
OneDriveLocation パラメーターは、ポリシーに含めるOneDrive for Businessサイトを指定します。 サイトを URL 値で指定することも、値 All を使用してすべてのサイトを含めることもできます。
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocationException
このパラメーターは、OneDriveLocation パラメーターの値 All を使用するときに除外するOneDrive for Businessサイトを指定します。 サイトは URL 値で指定します。
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OverwriteLabel
OverwriteLabel パラメーターは、手動ラベルを上書きするかどうかを指定します。 有効な値は次のとおりです。
- $true: 手動ラベルを上書きします。
- $false: 手動ラベルを上書きしないでください。 これは既定の値です。
このパラメーターは Exchange の場所でのみ機能します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PolicyRBACScopes
{{ Fill PolicyRBACScopes Description }}
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-PolicyTemplateInfo
このパラメーターは、Microsoft の内部使用のために予約されています。
Type: | PswsHashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Priority
Priority パラメーターは、ポリシーの優先順位を指定します。 ファイルに 2 つのポリシーが適用される場合、優先度の高いポリシーは優先度の低いポリシーに対してアクションを実行します。
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SharePointLocation
SharePointLocation パラメーターは、ポリシーに含める SharePoint Online サイトを指定します。 サイトを URL 値で指定することも、値 All を使用してすべてのサイトを含めることもできます。
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
SharePoint Online サイトは、インデックスが作成されるまでポリシーに追加できません。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SharePointLocationException
このパラメーターは、SharePointLocation パラメーターの値 All を使用するときに除外する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-UnifiedAuditLogEnabled
{{ Fill UnifiedAuditLogEnabled Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |