Get-Label
此 Cmdlet 僅適用於安全性與合規性 PowerShell。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
使用 Get-Label Cmdlet 來檢視貴組織中的敏感度標籤。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
Description
注意：如果您的組織有更多的 han 1000 敏感度標籤，則為 Powershell 工作階段設定的逾時設定可能會導致效能問題。 使用 SkipValidations 參數更有效率地擷取標籤。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-Label
此範例會傳回組織中所有敏感度標籤的摘要清單。
範例 2
Get-Label -Identity "Engineering Group" | Format-List
此範例會傳回名為 [工程群組] 的敏感度標籤的詳細資訊。
參數
-Identity
適用對象：安全性 & 合規性
此 Identity 參數會指定您要檢視的敏感度標籤。 您可以使用唯一識別標籤的任何值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。
參數屬性
| 類型: | ComplianceRuleIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeDetailedLabelActions
適用對象：安全性 & 合規性
IncludeDetailedLabelActions 參數會指定是否要將標籤動作展開為屬性，以提高可讀性。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReturnModernLabelScheme
適用對象：安全性 & 合規性
{{ 填滿 ReturnModernLabelScheme 描述 }}
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SkipValidations
適用對象：安全性 & 合規性
SkipValidations 參數可指定是否要略過擷取敏感度標籤中設定的加密屬性。 您不需要使用此參數指定值。
具有超過 1000 個標籤的組織可以使用此參數來減少擷取標籤所需的時間，這有助於防止 Cmdlet 發生逾時問題 Get-Label。
注意：擷取標籤時，使用此參數不會略過驗證。 只有在為標籤設定加密範本屬性時，它才會略過擷取加密範本屬性。 您可以使用 Get-Label 命令中的 Identity 參數來個別取得這些屬性。
此參數不會影響標籤的套用或發佈。 只有在擷取 CRUD 作業的標籤時，才會存在此限制。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ValidateContentTypeRemoval
適用對象：安全性 & 合規性
{{ Fill ValidateContentTypeRemoval 描述 }}
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。