Get-UserPrincipalNamesSuffix

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Get-UserPrincipalNamesSuffix, um die UpN-Suffixe (User Principal Name) in der Active Directory-Gesamtstruktur anzuzeigen. Die UPN-Suffixe werden in Active Directory-Domänen und -Vertrauensstellungen erstellt.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-UserPrincipalNamesSuffix
   [-OrganizationalUnit <ExtendedOrganizationalUnitIdParameter>]
   [<CommonParameters>]

Beschreibung

UPN-Suffixe, die einer Organisationseinheit zugewiesen sind, werden im Attribut upnSuffixes im Objekt Organizational Unit (Organisationseinheit) gespeichert.

Der Standard-UPN ist im Attribut Canonical Name des Objekts Partitions container (Partitionscontainer) im Konfigurationsbenennungskontext gespeichert. Das Standard-UPN-Suffix identifiziert die Domäne, in der sich das Benutzerkonto befindet. Wenn Sie ein Benutzerkonto in Active Directory erstellen, ist das Standardmäßige UPN-Suffix der DNS-Name der ersten Domäne in Ihrer Domänenstruktur.

Wenn Sie Benutzerkonten mithilfe von Active Directory-Benutzer und -Computer erstellen, muss jeder Benutzer über einen UPN verfügen.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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-UserPrincipalNamesSuffix

In diesem Beispiel werden alle UPN-Suffixe für die Active Directory-Gesamtstruktur zurückgegeben.

Parameter

-OrganizationalUnit

Der OrganizationalUnit-Parameter filtert die Ergebnisse basierend auf dem Speicherort des Objekts in Active Directory. Es werden nur Objekte zurückgegeben, die am angegebenen Speicherort vorhanden sind. Eine gültige Eingabe für diesen Parameter ist eine Organisationseinheit (OU) oder Domäne, die vom Cmdlet Get-OrganizationalUnit zurückgegeben wird. Sie können jeden beliebigen Wert verwenden, sofern er die Organisationseinheit oder Domäne eindeutig kennzeichnet. Beispiel:

Name
Name
Distinguished Name (DN)
GUID

Type:	ExtendedOrganizationalUnitIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.