Freigeben über

Get-UserPrincipalNamesSuffix

Modul:
Exchange PowerShell

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

Default (Standardwert) 

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. 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-UserPrincipalNamesSuffix

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

Parameter

-OrganizationalUnit

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Parametereigenschaften

Typ:ExtendedOrganizationalUnitIdParameter
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.