Get-RetentionPolicyTag
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen können für die eine oder die andere Umgebung exklusiv sein.
Verwenden Sie das Cmdlet Get-RetentionPolicyTag, um Einstellungen für ein Aufbewahrungstag abzurufen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Identity
Get-RetentionPolicyTag
[[-Identity] <RetentionPolicyTagIdParameter>]
[-DomainController <Fqdn>]
[-IncludeSystemTags]
[-Types <ElcFolderType[]>]
[<CommonParameters>]
Mailbox
Get-RetentionPolicyTag
[-Mailbox <MailboxIdParameter>]
[-OptionalInMailbox]
[-DomainController <Fqdn>]
[-IncludeSystemTags]
[-Types <ElcFolderType[]>]
[<CommonParameters>]
Beschreibung
Mithilfe von Aufbewahrungstags werden Einstellungen für die Aufbewahrung von Nachrichten auf Nachrichten oder Ordner angewendet. Es gibt drei Typen von Aufbewahrungstags:
- Aufbewahrungsrichtlinientags
- Standardrichtlinientags
- Persönliche Tags
Aufbewahrungsrichtlinientags werden auf Standardordner, wie z. B. "Posteingang" oder "Gelöschte Elemente", angewendet. Persönliche Tags stehen den Benutzern zum Kennzeichnen von Elementen und Ordnern zur Verfügung. Das Standardrichtlinientag wird auf alle Elemente angewendet, auf die der Benutzer kein Tag angewendet hat, oder die von dem Ordner, in dem sie sich befinden, kein Tag geerbt haben. Mit dem Cmdlet Get-RetentionPolicyTag werden alle Einstellungen für das angegebene Tag angezeigt.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Get-RetentionPolicyTag
In diesem Beispiel werden alle Aufbewahrungsrichtlinientags zurückgegeben.
Beispiel 2
Get-RetentionPolicyTag -IncludeSystemTags
In diesem Beispiel werden Systemtags sowie persönliche und Standardtags zurückgegeben.
Beispiel 3
Get-RetentionPolicyTag "Consolidated Messenger"
In diesem Beispiel werden die Einstellungen für das Tag "Consolidated Messenger" zurückgegeben.
Beispiel 4
Get-RetentionPolicyTag -Types Inbox,All | Format-Table Name,Type,RetentionEnabled,AgeLimitForRetention,RetentionAction -AutoSize
In diesem Beispiel werden alle Aufbewahrungstags der Typen Posteingang und Alle zurückgegeben, und die Ergebnisse werden an den Befehl Format-Table übermittelt, um die Eigenschaften Name, Type, RetentionEnabled, AgeLimitForRetention und RetentionAction anzuzeigen.
Parameter
-DomainController
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
Parametereigenschaften
| Typ: | Fqdn |
| 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 |
-Identity
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter Identity gibt den Namen des Tags an.
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: | RetentionPolicyTagIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Identity
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IncludeSystemTags
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Die Option IncludeSystemTags gibt an, ob Systemtags zurückgegeben werden. 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 |
-Mailbox
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter Mailbox gibt die Aufbewahrungstags zurück, die der Aufbewahrungsrichtlinie zugewiesen sind, die auf das angegebene Postfach angewendet wird. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\Benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Dieser Parameter gibt nur Standardrichtlinientags (DPTs) und persönliche Tags zurück. Es gibt keine Aufbewahrungsrichtlinientags zurück.
Parametereigenschaften
| Typ: | MailboxIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Mailbox
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-OptionalInMailbox
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter OptionalInMailbox wird zusammen mit dem Parameter Mailbox verwendet, um alle opt-in-Aufbewahrungstags zurückzugeben, die dem angegebenen Postfach zugewiesen sind. Sie müssen keinen Wert für diese Option angeben.
Ein opt-in-Aufbewahrungstag ist ein persönliches Tag, das dem Postfach explizit mit dem Befehl Set-RetentionPolicyTag -Mailbox -OptionalInMailbox zugewiesen wurde.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Mailbox
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Types
Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Der Parameter Types gibt den Typ des Aufbewahrungstags an, das zurückgegeben werden soll. Gültige Werte sind:
- Kalender
- Kontakte
- DeletedItems
- Entwürfe
- Posteingang
- JunkEmail
- Journal
- Notizen
- Postausgang
- SentItems
- Aufgaben
- Alle
- RssSubscriptions
- ConversationHistory
- Personal
Der Parameter akzeptiert mehrere Werte, wenn diese durch Kommata getrennt angegeben werden.
Parametereigenschaften
| Typ: | ElcFolderType[] |
| 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.
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.