Set-AutoSensitivityLabelPolicy

モジュール:

ExchangePowerShell

適用対象:

Security & Compliance

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

Set-AutoSensitivityLabelPolicy コマンドレットを使用して、organizationの自動ラベル付けポリシーを変更します。

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

構文

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-ApplySensitivityLabel <String>]
   [-AutoEnableAfter <Timespan>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-SpoAipIntegrationEnabled <Boolean>]
   [-StartSimulation <Boolean>]
   [-SystemOperation]
   [-WhatIf]
   [<CommonParameters>]

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-Mode <PolicyMode>]
   [-WhatIf]
   [<CommonParameters>]

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Confirm]
   [-Mode <PolicyMode>]
   [-RetryDistribution]
   [-WhatIf]
   [<CommonParameters>]

説明

セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。

例

例 1

Set-AutoSensitivityLabelPolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

次の使用例は、指定した URL を SharePoint Online に追加し、既存の URL 値に影響を与えずに Main PII という名前の自動ラベル付けポリシーの場所をOneDrive for Businessします。

パラメーター

-AddExchangeLocation

AddExchangeLocation パラメーターは、電子メール メッセージがまだ含まれていない場合にポリシーに追加します。 このパラメーターの有効な値は All です。

ポリシーに電子メール メッセージがまだ含まれていない場合 (Get-AutoSensitivityLabelPolicy コマンドレットの出力に ExchangeLocation プロパティの値が空白です)、次の手順でこのパラメーターを使用できます。

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

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

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

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

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

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddOneDriveLocation

AddOneDriveLocation パラメーターは、OneDriveLocation パラメーターの値 All を使用していない場合に含まれるサイトの一覧に追加するOneDrive for Business サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddOneDriveLocationException

AddOneDriveLocationException パラメーターは、OneDriveLocation パラメーターの値 All を使用するときに、除外されたサイトの一覧に追加するOneDrive for Business サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddSharePointLocation

AddSharePointLocation パラメーターは、SharePointLocation パラメーターの値 All を使用していない場合に含まれるサイトの一覧に追加する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

SharePoint Online サイトは、インデックスが作成されるまでポリシーに追加できません。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AddSharePointLocationException

AddSharePointLocationException パラメーターは、SharePointLocation パラメーターの値 All を使用するときに、除外されたサイトの一覧に追加する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ApplySensitivityLabel

ApplySensitivityLabel パラメーターは、ポリシーに使用するラベルを選択します。 これにより、ポリシーの前のラベルがオーバーライドされます。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-AutoEnableAfter

AutoEnableAfter パラメーターを使用すると、シミュレーションで設定された期間の後にポリシーを自動的にオンにすることができます。 この期間は、ポリシーを変更したとき、またはシミュレーションがトリガーされるたびに再起動されます。

値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。

有効な値は 1 時間から 25 日間です。

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

Type:	System.TimeSpan
Position:	Named
Default value:	None
Required:	False
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

-Enabled

Enabled パラメーターは、ポリシーを有効または無効にします。 有効な値は次のとおりです。

• $true: ポリシーを有効にします。 これは既定の値です。
• $true: ポリシーを有効にします。これが既定値です。

Type:	Boolean
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>"

このパラメーターを使用するには、次のいずれかのステートメントが true である必要があります。

• ポリシーには既に電子メール メッセージが含まれています (Get-AutoSensitivityLabelPolicy コマンドレットの出力では、ExchangeLocation プロパティの値は All です)。
• このパラメーターと同じコマンドで を使用 -AddExchangeLocation All します。

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>"

このパラメーターを使用するには、次のいずれかのステートメントが true である必要があります。

• ポリシーには既に電子メール メッセージが含まれています (Get-AutoSensitivityLabelPolicy の出力では、ExchangeLocation プロパティの値は All です)。
• このパラメーターと同じコマンドで を使用 -AddExchangeLocation All します。

このパラメーターは、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>"

このパラメーターを使用するには、次のいずれかのステートメントが true である必要があります。

• ポリシーには既に電子メール メッセージが含まれています (Get-AutoSensitivityLabelPolicy の出力では、ExchangeLocation プロパティの値は All です)。
• このパラメーターと同じコマンドで を使用 -AddExchangeLocation All します。

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>"

このパラメーターを使用するには、次のいずれかのステートメントが true である必要があります。

• ポリシーには既に電子メール メッセージが含まれています (Get-AutoSensitivityLabelPolicy の出力では、ExchangeLocation プロパティの値は All です)。
• このパラメーターと同じコマンドで を使用 -AddExchangeLocation All します。

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

既存のメール アドレスをクリアするには、$null値を使用します。

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

-Identity

Identity パラメーターは、変更する自動ラベル付けポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• 識別名 (DN)
• GUID

Type:	PolicyIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Security & Compliance

-Mode

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

• 有効: アクションと通知に対してポリシーが有効になっています。
• Enable: ポリシーはアクションと通知に関して有効です。これが既定値です。
• TestWithNotifications: サポートされていません。
• TestWithoutNotifications: アクションが実行されておらず、通知が送信されない監査モード (テスト モード)。

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

-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 パラメーターは、ポリシー処理の順序を決定するポリシーの優先順位値を指定します。 整数値が小さい場合は優先度が高いことを示し、値 0 は最も高い優先順位を示し、ポリシーの優先度の値を同じにすることはできません。

このパラメーターの有効な値と既定値は、既存のポリシーの数によって異なります。 たとえば、既存のポリシーが 5 つある場合は、次のようになります。

• 既存の 5 つのポリシーの有効な優先順位の値は 0 から 4 です。
• 新しい 6 番目のポリシーの有効な優先順位の値は 0 から 5 です。
• 新しい 6 番目のポリシーの既定値は 5 です。

ポリシーの優先順位の値を変更すると、一覧内のポリシーの位置が、指定した優先順位の値と一致するように変更されます。 つまり、ポリシーの優先順位の値を既存のポリシーと同じ値に設定した場合、既存のポリシーの優先度値と、その他のすべての低優先度ポリシーは、1 ずつ増やされます。

Type:	System.Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveExchangeLocation

RemoveExchangeLocation パラメーターは、既に含まれている場合は、ポリシーから電子メール メッセージを削除します。 このパラメーターの有効な値は All です。

ポリシーに電子メール メッセージが既に含まれている場合 (Get-AutoSensitivityLabelPolicy コマンドレットの出力で ExchangeLocation プロパティの値は All)、ポリシーが電子メール メッセージに適用されないようにするために使用 -RemoveExchangeLocation All できます。

電子メール (Exchange の値) が関連付けられているいずれかのルールで使用されている場合、このパラメーターを使用することはできません。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveOneDriveLocation

RemoveOneDriveLocation パラメーターは、OneDriveLocation パラメーターの値 All を使用していない場合に含まれるサイトの一覧から削除するOneDrive for Business サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveOneDriveLocationException

この RemoveOneDriveLocationException パラメーターは、OneDriveLocation パラメーターの値 All を使用するときに、除外されたサイトの一覧から削除するOneDrive for Business サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveSharePointLocation

RemoveSharePointLocation パラメーターは、SharePointLocation パラメーターの値 All を使用していない場合に含まれるサイトの一覧から削除する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RemoveSharePointLocationException

RemoveSharePointLocationException パラメーターは、SharePointLocation パラメーターの値 All を使用するときに、除外されたサイトの一覧から削除する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

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

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-RetryDistribution

RetryDistribution スイッチは、ポリシーをすべてのOneDrive for Businessと SharePoint Online の場所に再配布します。 このスイッチで値を指定する必要はありません。

初期の配布が成功した場所は、再試行に含まれません。 このスイッチを使用すると、ポリシーの配布エラーが報告されます。

注: 配布を再試行するプロセスは重要な操作であるため、必要な場合にのみ、一度に 1 つのポリシーに対して実行してください。 ポリシーを更新するたびに実行されるわけではありません。 スクリプトを実行して複数のポリシーを更新する場合は、ポリシーの配布が成功するまで待ってから、次のポリシーのコマンドをもう一度実行します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SpoAipIntegrationEnabled

{{ Fill SpoAipIntegrationEnabled Description }}

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-StartSimulation

StartSimulation パラメーターを使用して、更新された結果のシミュレーションを再起動します。 有効な値は次のとおりです。

• $true: 更新された結果のシミュレーションを再起動します。
• $false: これが既定値です

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-SystemOperation

{{ Fill SystemOperation Description }}

Type:	SwitchParameter
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