Set-LabelPolicy
此 Cmdlet 只能在安全 & 性合規性 PowerShell 中運作。 如需詳細資訊，請參閱 安全 & 性合規性 PowerShell。
使用 Set-Label Cmdlet 來修改組織中的敏感度標籤原則。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
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>] Description
若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。 如需詳細資訊，請參閱 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
當您未針對 ExchangeLocation 參數使用 All 值時，AddExchangeLocation 參數會指定要新增至內含信箱清單的信箱。 有效的值是信箱。
若要指定信箱，您可以使用可唯一識別信箱的任何值。 例如：
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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
當您針對 ExchangeLocation 參數使用 All 值時，AddExchangeLocationException 參數會指定要新增至排除信箱清單的信箱。 有效的值是信箱。
若要指定信箱，您可以使用可唯一識別信箱的任何值。 例如：
- 名稱
- 名稱
- 辨別名稱 (DN)
- GUID
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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 位址。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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 參數可啟用敏感度標籤原則的用戶端特定功能。
使用原則的標識 (名稱或 GUID) 指定此參數，並在 雜湊表中使用索引鍵/值組。 若要移除進階設定，請使用相同的 AdvancedSettings 參數語法，但指定 Null 字串值。
您使用此參數設定的大部分設定，僅由 Azure 資訊保護統一標籤用戶端支援，而不是由支援內建標籤的 Office 應用程式支援。 如需指示，請參閱Azure 資訊保護統一標籤用戶端的自訂設定。
內建標籤的支援設定：
AttachmentAction：未標記的電子郵件會從檔案附件繼承最高優先順序的標籤。 將值設定為 [自動 (]，以自動將標籤套用) 或 建議 的 (作為建議的提示套用至使用者。 範例:
Set-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}。 如需此設定選擇的詳細資訊， 請參閱設定電子郵件附件的標籤繼承。EnableAudit：防止 Office 應用程式將敏感度標籤資料傳送至 Microsoft 365 稽核解決方案。 支援的應用程式：Windows (版本 2201+) 、macOS (16.57+) 版、iOS (2.57+ 版) ，以及 Android (16.0.14827+ 版) 的 Word、Excel 和 PowerPoint;Outlook on Windows (version 2201+) 、Outlook 網頁版，並推出至 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 參數會指定選擇性註解。 如果指定的值含有空格，則必須以雙引號 (") 括住值，例如︰"This is an admin note"。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 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
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
{{ 填入原則RBACScopes 描述 }}
| 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
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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 位址。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "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位置。 您不需要使用此參數指定值。
初始配送成功的位置不包含在重試中。 當您使用此參數時會回報原則配送錯誤。
注意：因為重試散發的程式是一項相當重要的作業，所以請只在必要時執行它，同時針對一個原則執行它。 並非要在每次更新原則時執行。 如果您執行腳本來更新多個原則，請等到原則發佈成功之後，再針對下一個原則再次執行命令。
| 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 |