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 Ihr 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
In diesem Beispiel wird eine Zusammenfassungsliste aller Vertraulichkeitsbezeichnungen im organization zurückgegeben.
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: Security & 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
Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter 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: Security & Compliance
Der IncludeDetailedLabelActions-Parameter gibt an, ob Bezeichnungsaktionen in Eigenschaften erweitert werden sollen, um die Lesbarkeit zu verbessern. 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: Security & 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: Security & Compliance
Der SkipValidations-Schalter gibt an, ob der Abruf der 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 Swtich verwenden, um die zum Abrufen der Bezeichnungen erforderliche Zeit zu verkürzen, wodurch Timeoutprobleme mit Get-Label Cmdlet verhindert werden.
Hinweis: Die Verwendung dieses Schalters überspringt beim Abrufen von Bezeichnungen keine Überprüfungen. Der Abruf von Verschlüsselungsvorlageneigenschaften wird nur übersprungen, wenn sie für eine Bezeichnung konfiguriert sind. Sie können diese Eigenschaften einzeln abrufen, indem Sie den Identity-Parameter im befehl Get-Label verwenden.
Dieser Schalter wirkt sich nicht auf die Bezeichnungsanwendung oder -verteilung aus. Die Einschränkung besteht nur beim Abrufen von Bezeichnungen 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: Security & 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.