Get-Label
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie das Cmdlet Get-Label, um Vertraulichkeitsbezeichnungen in Ihrem organization anzuzeigen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Get-Label
[[-Identity] <ComplianceRuleIdParameter>]
[-IncludeDetailedLabelActions]
[-SkipValidations]
[-ReturnModernLabelScheme]
[-ValidateContentTypeRemoval]
[<CommonParameters>]
Beschreibung
Hinweis: Wenn Ihre organization über mehr han 1000-Vertraulichkeitsbezeichnungen verfügt, können die für die Powershell-Sitzung festgelegten Timeouteinstellungen Leistungsprobleme verursachen. Verwenden Sie den SkipValidations-Parameter, um Bezeichnungen effizienter abzurufen.
Um dieses Cmdlet in Security & Compliance PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.
Beispiele
Beispiel 1
Get-Label
Dieses Beispiel gibt eine Zusammenfassungsliste aller Vertraulichkeitsbezeichnungen in der organization zurück.
Beispiel 2
Get-Label -Identity "Engineering Group" | Format-List
In diesem Beispiel werden ausführliche Informationen für die Vertraulichkeitsbezeichnung "Engineering Group" zurückgegeben.
Parameter
-Identity
Anwendbar: Sicherheit & Compliance
Der Parameter "Identity" gibt die Vertraulichkeitsbezeichnung an, die Sie anzeigen möchten. Sie können jeden beliebigen Wert verwenden, der die Bezeichnung eindeutig identifiziert. Zum Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.
Parametereigenschaften
| Typ: | ComplianceRuleIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IncludeDetailedLabelActions
Anwendbar: Sicherheit & Compliance
Der Parameter IncludeDetailedLabelActions gibt an, ob Bezeichnungsaktionen zur besseren Lesbarkeit in Eigenschaften erweitert werden sollen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ReturnModernLabelScheme
Anwendbar: Sicherheit & Compliance
{{ Fill ReturnModernLabelScheme Description }}
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SkipValidations
Anwendbar: Sicherheit & Compliance
Der Schalter SkipValidations gibt an, ob der Abruf von in Vertraulichkeitsbezeichnungen konfigurierten Verschlüsselungseigenschaften übersprungen werden soll. Sie müssen keinen Wert für diese Option angeben.
Organisationen mit mehr als 1.000 Bezeichnungen können diesen Schalter verwenden, um die Zeit zu reduzieren, die zum Abrufen der Bezeichnungen erforderlich ist, wodurch Timeoutprobleme mit Get-Label Cmdlet vermieden werden.
Hinweis: Wenn Sie diesen Schalter verwenden, werden Überprüfungen beim Abrufen von Etiketten nicht übersprungen. Das Abrufen von Verschlüsselungsvorlageneigenschaften wird nur übersprungen, wenn sie für eine Bezeichnung konfiguriert sind. Sie können diese Eigenschaften einzeln abrufen, indem Sie den Parameter "Identity" im Befehl "Get-Label" verwenden.
Diese Option wirkt sich nicht auf die Bezeichnungsanwendung oder -verteilung aus. Die Einschränkung besteht nur beim Abrufen von Labels für CRUD-Vorgänge.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ValidateContentTypeRemoval
Anwendbar: Sicherheit & Compliance
{{ Fill ValidateContentTypeRemoval Description }}
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.