New-AutoSensitivityLabelPolicy

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Security & Compliance

このコマンドレットは、セキュリティ & コンプライアンス 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