New-AutoSensitivityLabelPolicy

モジュール:

ExchangePowerShell

適用対象:

Security & Compliance

このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。

New-AutoSensitivityLabelPolicy コマンドレットを使用して、organizationで自動ラベル付けポリシーを作成します。 New-AutoSensitivityLabelRule コマンドレットを使用して自動ラベル付けポリシー 規則を作成し、ポリシーに関連付けてポリシーの作成を完了します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-AutoSensitivityLabelPolicy
   [-Name] <String>
   -ApplySensitivityLabel <String>
   [-Comment <String>]
   [-Confirm]
   [-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
   [-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-ExchangeAdaptiveScopes <MultiValuedProperty>]
   [-ExchangeAdaptiveScopesException <MultiValuedProperty>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Locations <String>]
   [-Mode <PolicyMode>]
   [-OneDriveAdaptiveScopes <MultiValuedProperty>]
   [-OneDriveAdaptiveScopesException <MultiValuedProperty>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-OneDriveSharedBy <RecipientIdParameter[]>]
   [-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-SharePointAdaptiveScopes <MultiValuedProperty>]
   [-SharePointAdaptiveScopesException <MultiValuedProperty>]
   [-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 パラメーターは、自動ラベル付けポリシーに使用するラベルを指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-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

-ExceptIfOneDriveSharedBy

ExceptIfOneDriveSharedBy パラメーターは、ポリシーから除外するユーザーを指定します (OneDrive for Business ユーザー アカウントのサイトはポリシーに含まれます)。 UPN (laura@contoso.onmicrosoft.com) によってユーザーを識別します。

このパラメーターを使用するには、OneDrive for Businessサイトをポリシーに含める必要があります (OneDriveLocation パラメーターの値は All で、既定値)。

複数の値を入力するには、次の構文を使用します: <value1>,<value2>,...<valueX>。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "<value1>","<value2>",..."<valueX>"。

OneDriveSharedBy パラメーターでは、このパラメーターを使用できません。

型:	RecipientIdParameter[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExceptIfOneDriveSharedByMemberOf

{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}

型:	RecipientIdParameter[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeAdaptiveScopes

{{ Fill ExchangeAdaptiveScopes Description }}

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeAdaptiveScopesException

{{ Fill ExchangeAdaptiveScopesException Description }}

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeLocation

ExchangeLocation パラメーターは、ポリシーに電子メール メッセージを含めるかどうかを指定します。 このパラメーターの有効な値は All です。 ポリシーに電子メール メッセージを含めない場合は、このパラメーターを使用しないでください (既定値は空白または$null)。

このパラメーターは、次の手順で使用できます。

• -ExchangeLocation Allを単独で使用する場合、ポリシーはすべての内部ユーザーの電子メールに適用されます。

• ポリシーに特定の内部ユーザーまたは外部ユーザーの電子メールを含める場合は、同じコマンドで ExchangeSender パラメーターで -ExchangeLocation All を使用します。 指定したユーザーのメールのみがポリシーに含まれます。

• ポリシーに特定のグループ メンバーの電子メールのみを含める場合は、同じコマンドで ExchangeSenderMemberOf パラメーターで -ExchangeLocation All を使用します。 ポリシーには、指定したグループのメンバーの電子メールのみが含まれます。

• ポリシーから特定の内部ユーザーの電子メールを除外するには、同じコマンドで ExchangeSenderException パラメーターで -ExchangeLocation All を使用します。 指定したユーザーのメールのみがポリシーから除外されます。

• ポリシーから特定のグループ メンバーの電子メールのみを除外するには、同じコマンドの ExchangeSenderMemberOfException パラメーターで -ExchangeLocation All を使用します。 指定したグループのメンバーの電子メールのみがポリシーから除外されます。

同じポリシーに包含と除外を指定することはできません。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeSender

ExchangeSender パラメーターは、メールがポリシーに含まれているユーザーを指定します。 ユーザーを電子メール アドレスで識別します。 内部または外部のメール アドレスを指定できます。

複数の値を入力するには、次の構文を使用します: <value1>,<value2>,...<valueX>。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "<value1>","<value2>",..."<valueX>"。

このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。

ExchangeSenderException パラメーターまたは ExchangeSenderMemberOfException パラメーターでは、このパラメーターを使用できません。

型:	SmtpAddress[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeSenderException

ExchangeSenderException パラメーターは、メールがポリシーから除外される内部ユーザーを指定します。 ユーザーを電子メール アドレスで識別します。

複数の値を入力するには、次の構文を使用します: <value1>,<value2>,...<valueX>。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "<value1>","<value2>",..."<valueX>"。

このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。

このパラメーターは、ExchangeSender パラメーターまたは ExchangeSenderMemberOf パラメーターでは使用できません。

型:	SmtpAddress[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeSenderMemberOf

ExchangeSenderMemberOf パラメーターは、ポリシーに含める配布グループまたはメールが有効なセキュリティ グループを指定します (グループ メンバーの電子メールはポリシーに含まれます)。 グループはメール アドレスで識別します。

複数の値を入力するには、次の構文を使用します: <value1>,<value2>,...<valueX>。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "<value1>","<value2>",..."<valueX>"。

このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。

ExchangeSenderException パラメーターまたは ExchangeSenderMemberOfException パラメーターでは、このパラメーターを使用できません。

このパラメーターを使用してMicrosoft 365 グループを指定することはできません。

型:	SmtpAddress[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExchangeSenderMemberOfException

ExchangeSenderMemberOfException パラメーターは、ポリシーから除外する配布グループまたはメールが有効なセキュリティ グループを指定します (グループ メンバーの電子メールはポリシーから除外されます)。 グループはメール アドレスで識別します。

複数の値を入力するには、次の構文を使用します: <value1>,<value2>,...<valueX>。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "<value1>","<value2>",..."<valueX>"。

このパラメーターは、ExchangeLocation パラメーターと共に使用する必要があります。

このパラメーターは、ExchangeSender パラメーターまたは ExchangeSenderMemberOf パラメーターでは使用できません。

このパラメーターを使用してMicrosoft 365 グループを指定することはできません。

型:	SmtpAddress[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-ExternalMailRightsManagementOwner

ExternalMailRightsManagementOwner パラメーターは、RMS を使用して外部送信者からの受信電子メール メッセージを暗号化するために使用されるユーザー メールボックスのメール アドレスを指定します。

このパラメーターは Exchange の場所でのみ機能し、ポリシーは暗号化アクションを持つラベルを適用する必要があります。

型:	SmtpAddress
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-Force

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-Locations

{{ Fill Locations Description }}

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-Mode

Mode パラメーターは、自動ラベル付けポリシーのアクションと通知レベルを指定します。 有効な値は次のとおりです。

• 有効: アクションと通知に対してポリシーが有効になっています。 これは既定の値です。
• Enable: ポリシーはアクションと通知に関して有効です。これが既定値です。
• Disable: ポリシーを無効にします。
• TestWithNotifications: アクションは実行されませんが、通知が送信されます。

型:	PolicyMode
指定可能な値:	Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-Name

Name パラメーターは、自動ラベル付けポリシーの一意の名前を指定します。 値にスペースが含まれている場合は、値を引用符 (") で囲みます。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OneDriveAdaptiveScopes

{{ Fill OneDriveAdaptiveScopes Description }}

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OneDriveAdaptiveScopesException

{{ Fill OneDriveAdaptiveScopesException Description }}

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OneDriveLocation

OneDriveLocation パラメーターは、ポリシーに含めるOneDrive for Businessサイトを指定します。 サイトを URL 値で指定することも、値 All を使用してすべてのサイトを含めることもできます。

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OneDriveLocationException

このパラメーターは、OneDriveLocation パラメーターの値 All を使用するときに除外するOneDrive for Businessサイトを指定します。 サイトは URL 値で指定します。

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OneDriveSharedBy

OneDriveSharedBy パラメーターは、ポリシーに含めるユーザーを指定します (OneDrive for Business ユーザー アカウントのサイトはポリシーに含まれます)。 UPN (laura@contoso.onmicrosoft.com) によってユーザーを識別します。

このパラメーターを使用するには、OneDrive for Businessサイトをポリシーに含める必要があります (OneDriveLocation パラメーターの値は All で、既定値)。

複数の値を入力するには、次の構文を使用します: <value1>,<value2>,...<valueX>。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "<value1>","<value2>",..."<valueX>"。

ExceptIfOneDriveSharedBy パラメーターでは、このパラメーターを使用できません。

型:	RecipientIdParameter[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OneDriveSharedByMemberOf

{{ Fill OneDriveSharedByMemberOf Description }}

型:	RecipientIdParameter[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-OverwriteLabel

OverwriteLabel パラメーターは、手動ラベルを上書きするかどうかを指定します。 有効な値は次のとおりです。

• $true: 手動ラベルを上書きします。
• $false: 手動ラベルを上書きしないでください。 これは既定の値です。

このパラメーターは Exchange の場所でのみ機能します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-PolicyRBACScopes

PolicyRBACScopes パラメーターは、ポリシーに割り当てる管理単位を指定します。 有効な値は、管理単位のMicrosoft Entra ObjectID (GUID 値) です。 複数の値をコンマで区切って指定できます。

管理単位は、Microsoft Entra ID P1 または P2 でのみ使用できます。 管理単位は、Microsoft Graph PowerShell で作成および管理します。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-PolicyTemplateInfo

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

型:	PswsHashtable
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-Priority

Priority パラメーターは、ポリシーの優先順位を指定します。 ファイルに 2 つのポリシーが適用される場合、優先度の高いポリシーは優先度の低いポリシーに対してアクションを実行します。

型:	System.Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-SharePointAdaptiveScopes

{{ Fill SharePointAdaptiveScopes Description }}

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-SharePointAdaptiveScopesException

{{ Fill SharePointAdaptiveScopesException Description }}

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-SharePointLocation

SharePointLocation パラメーターは、ポリシーに含める SharePoint Online サイトを指定します。 サイトを URL 値で指定することも、値 All を使用してすべてのサイトを含めることもできます。

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。 SharePoint Online サイトは、インデックスが作成されるまでポリシーに追加できません。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-SharePointLocationException

このパラメーターは、SharePointLocation パラメーターの値 All を使用するときに除外する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

Update 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。

型:	MultiValuedProperty
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-UnifiedAuditLogEnabled

{{ Fill UnifiedAuditLogEnabled Description }}

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance

-WhatIf

WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Security & Compliance