Set-LabelPolicy
このコマンドレットは、セキュリティ & コンプライアンス PowerShell でのみ機能します。 詳細については、「 セキュリティ & コンプライアンス PowerShell」を参照してください。
Set-Label コマンドレットを使用して、組織内の秘密度ラベル ポリシーを変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-LabelPolicy
[-Identity] <PolicyIdParameter>
-RetryDistribution
[-AddLabels <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Confirm]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PreviousLabelPolicy <PolicyIdParameter>]
[-RemoveLabels <MultiValuedProperty>]
[<CommonParameters>] Set-LabelPolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddLabels <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-AddOneDriveLocation <MultiValuedProperty>]
[-AddOneDriveLocationException <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-AddSharePointLocationException <MultiValuedProperty>]
[-AddSkypeLocation <MultiValuedProperty>]
[-AddSkypeLocationException <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveLabels <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RemoveOneDriveLocation <MultiValuedProperty>]
[-RemoveOneDriveLocationException <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-RemoveSharePointLocationException <MultiValuedProperty>]
[-RemoveSkypeLocation <MultiValuedProperty>]
[-RemoveSkypeLocationException <MultiValuedProperty>]
[<CommonParameters>] Set-LabelPolicy
[-Identity] <PolicyIdParameter>
[-AddLabels <MultiValuedProperty>]
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-Force]
[-MigrationId <String>]
[-NextLabelPolicy <PolicyIdParameter>]
[-PreviousLabelPolicy <PolicyIdParameter>]
[-RemoveLabels <MultiValuedProperty>]
[-Setting <PswsHashtable>]
[-Settings <PswsHashtable>]
[-WhatIf]
[<CommonParameters>] 説明
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
注: スコープの場所を追加または削除するときは、パイプForeach-Object コマンドを使用しないでください。 "Value1","Value2",..."ValueN" | Foreach-Object {Set-LabelPolicy -Identity "Global Policy" -RemoveExchangeLocation $_ }
例
例 1
Set-LabelPolicy -Identity "Global Policy" -AdvancedSettings @{EnableCustomPermissions="False"}次の使用例は、秘密度ラベル ポリシー名グローバル ポリシーの指定された詳細設定を構成します。
パラメーター
-AddExchangeLocation
AddExchangeLocation パラメーターは、ExchangeLocation パラメーターの値 All を使用していない場合に含まれるメールボックスの一覧に追加するメールボックスを指定します。 有効な値はメールボックスです。
メールボックスを指定するには、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
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 |
-AddExchangeLocationException
AddExchangeLocationException パラメーターは、ExchangeLocation パラメーターの値 All を使用するときに、除外されたメールボックスの一覧に追加するメールボックスを指定します。 有効な値はメールボックスです。
メールボックスを指定するには、メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- 名前
- 識別名 (DN)
- GUID
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 |
-AddLabels
AddLabels パラメーターは、ポリシーに追加する秘密度ラベルを指定します。 ラベルを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
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 |
-AddModernGroupLocation
AddModernGroupLocation パラメーターは、含まれるMicrosoft 365 グループの一覧に追加するMicrosoft 365 グループを指定します。 Microsoft 365 グループを識別するには、プライマリ SMTP アドレスを使用する必要があります。
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 |
-AddModernGroupLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddOneDriveLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddOneDriveLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddPublicFolderLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSkypeLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSkypeLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AdvancedSettings
AdvancedSettings パラメーターを使用すると、秘密度ラベル ポリシーのクライアント固有の機能が有効になります。
このパラメーターは、ポリシーの ID (名前または GUID) で指定し、 ハッシュ テーブルにキーと値のペアを指定します。 詳細設定を削除するには、同じ AdvancedSettings パラメーター構文を使用しますが、null 文字列値を指定します。
このパラメーターで構成する設定のほとんどは、組み込みのラベル付けをサポートする Office アプリではなく、Azure Information Protection統合ラベル付けクライアントでのみサポートされます。 手順については、「Azure Information Protection統合ラベル付けクライアントのカスタム構成」を参照してください。
組み込みのラベル付けに対してサポートされている設定:
AttachmentAction: ラベル付けされていないメールは、最も優先度の高いラベルを添付ファイルから継承します。 値を [自動 ] (ラベルを自動的に適用する) または [推奨] (推奨プロンプトとしてユーザーに適用する) に設定します。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}。 この構成の選択の詳細については、「 電子メールの添付ファイルからのラベル継承を構成する」を参照してください。EnableAudit: Office アプリが秘密度ラベル データを Microsoft 365 監査ソリューションに送信できないようにします。 サポートされているアプリ: Windows 上の Word、Excel、PowerPoint (バージョン 2201 以降)、macOS (バージョン 16.57 以降)、iOS (バージョン 2.57 以降)、Android (バージョン 16.0.14827 以降)。Outlook on Windows (バージョン 2201 以降)、Outlook on the web、macOS、iOS、Android へのロールアウト。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}。DisableMandatoryInOutlook: この設定をサポートする Outlook アプリは、Outlook メッセージを必須のラベル付けから除外します。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}。 この構成の選択の詳細については、「 既定のラベル付けと必須ラベル付けの Outlook 固有のオプション」を参照してください。OutlookDefaultLabel: この設定をサポートする Outlook アプリは、既定のラベルを適用するか、ラベルを適用しません。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}。 この構成の選択の詳細については、「 既定のラベル付けと必須ラベル付けの Outlook 固有のオプション」を参照してください。TeamworkMandatory: この設定をサポートする Outlook アプリと Teams アプリでは、会議の必須ラベル付けを有効または無効にすることができます。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}。 会議のラベル付けの詳細については、「 秘密度ラベルを使用して予定表アイテム、Teams 会議、チャットを保護する」を参照してください。teamworkdefaultlabelid: この設定をサポートする Outlook アプリと Teams アプリでは、既定のラベルが適用されるか、会議にラベルが適用されません。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}。 会議のラベル付けの詳細については、「 秘密度ラベルを使用して予定表アイテム、Teams 会議、チャットを保護する」を参照してください。HideBarByDefault: 秘密度バーをサポートする Office アプリの場合は、長いファイル名を表示する領域が増えるように、ウィンドウ バーのタイトルに秘密度ラベル名を表示しないでください。 ラベル アイコンと色 (構成されている場合) だけが表示されます。 ユーザーはアプリでこの設定を元に戻すことはできません。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}
さらに、Power BI の場合:
powerbimandatory: Power BI の必須ラベル付け。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}。 この構成の選択の詳細については、「 Power BI の必須ラベル ポリシー」を参照してください。powerbidefaultlabelid: Power BI コンテンツの既定のラベル。 例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}。 この構成の選択の詳細については、「 Power BI の既定のラベル ポリシー」を参照してください。
| Type: | PswsHashtable |
| 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 |
-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: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-MigrationId
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-NextLabelPolicy
NextLabelPolicy パラメーターは、このパラメーターで指定されているポリシーが変更中の現在のポリシーの後になるように、ポリシーの順序を更新します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
| Type: | PolicyIdParameter |
| 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 |
-PreviousLabelPolicy
PreviousLabelPolicy パラメーターは、このパラメーターで指定されているポリシーが変更中の現在のポリシーの前になるように、ポリシーの順序を更新します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
| Type: | PolicyIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
RemoveExchangeLocation パラメーターは、ExchangeLocation パラメーターの値 All を使用していない場合に含まれるメールボックスの一覧から削除するメールボックスを指定します。 有効な値は次のとおりです。
- ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。有効な値は次のとおりです。
- メールボックス。
すべてのメールボックスに対する値 All。 この値のみ、それ自体で使用できます。
- 名前
- 名前
- 識別名 (DN)
- GUID
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 |
-RemoveExchangeLocationException
RemoveExchangeLocationException パラメーターは、ExchangeLocation パラメーターの値 All を使用しているときに、除外されたメールボックスの一覧から削除するメールボックスを指定します。 有効な値は次のとおりです。
- ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。有効な値は次のとおりです。
- メールボックス。
すべてのメールボックスに対する値 All。 この値のみ、それ自体で使用できます。
- 名前
- 名前
- 識別名 (DN)
- GUID
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 |
-RemoveLabels
RemoveLabels パラメーターは、ポリシーから削除する秘密度ラベルを指定します。 ラベルを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
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 |
-RemoveModernGroupLocation
RemoveModernGroupLocation パラメーターは、含まれているグループの一覧から削除するMicrosoft 365 グループを指定します。 Microsoft 365 グループを識別するには、プライマリ SMTP アドレスを使用する必要があります。
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 |
-RemoveModernGroupLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveOneDriveLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveOneDriveLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemovePublicFolderLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSkypeLocation
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSkypeLocationException
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RetryDistribution
RetryDistribution スイッチは、ポリシーをすべてのExchange Online場所に再配布するかどうかを指定します。 このスイッチで値を指定する必要はありません。
初期の配布が成功した場所は、再試行に含まれません。 このスイッチを使用すると、ポリシーの配布エラーが報告されます。
注: 配布を再試行するプロセスは重要な操作であるため、必要な場合にのみ、一度に 1 つのポリシーに対して実行してください。 ポリシーを更新するたびに実行されるわけではありません。 スクリプトを実行して複数のポリシーを更新する場合は、ポリシーの配布が成功するまで待ってから、次のポリシーのコマンドをもう一度実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Setting
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | PswsHashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Settings
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | PswsHashtable |
| 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 |