Identität

Gilt für: Exchange Server 2013

Der Identity-Parameter ist ein spezieller Parameter, den Sie mit den meisten Cmdlets verwenden können. Mit dem Identity-Parameter erhalten Sie Zugriff auf die eindeutigen Bezeichner, die auf ein bestimmtes Objekt in Microsoft Exchange Server 2013 verweisen. Auf diese Weise können Sie Aktionen für ein bestimmtes Exchange 2013-Objekt ausführen.

In den folgenden Abschnitten wird der Parameter Identity beschrieben. Ferner werden Beispiele für dessen effektive Verwendung genannt:

Characteristics of the Identity parameter

Wildcard characters in Identity

Examples of the Identity parameter

Eigenschaften des Parameters "Identity"

Der primäre eindeutige Bezeichner eines Objekts in Exchange 2013 ist immer eine GUID. Eine GUID ist ein 128-Bit-Bezeichner, z 63d64005-42c5-4f8f-b310-14f6cb125bf3. B. . Diese GUID wiederholt sich nie und ist daher immer eindeutig. Sie möchten solche GUIDs jedoch nicht regelmäßig eingeben. Daher besteht der Identity-Parameter in der Regel auch aus den Werten anderer Parameter oder einem kombinierten Satz von Werten aus mehreren Parametern für ein einzelnes Objekt. Diese Werte sind auch garantiert für diese Gruppe von Objekten eindeutig. Sie können die Werte dieser anderen Parameter angeben, z. B. Name und DistriguishedName, oder sie können vom System generiert werden. Die zusätzlichen Parameter, die ggf. verwendet werden, und wie sie aufgefüllt werden, hängen vom Objekt ab, auf das Sie verweisen.

Der Identity-Parameter wird auch als Positionsparameter betrachtet. Es wird davon ausgegangen, dass das erste Argument eines Cmdlets der Identity-Parameter ist, wenn keine Parameterbezeichnung angegeben wird. Auf diese Weise wird die Anzahl der Tastatureingaben beim Eingeben von Befehlen verringert. Weitere Informationen zu Positionsparametern finden Sie unter Parameters.

Das folgende Beispiel zeigt die Verwendung des Parameters Identity mithilfe des eindeutigen Name-Parameterwerts des Empfangsconnectors. Dieses Beispiel zeigt auch, wie Sie den Identity-Parameternamen weglassen können, da Identity ein Positionsparameter ist.

Get-ReceiveConnector -Identity "From the Internet"
Get-ReceiveConnector "From the Internet"

Wie alle Objekte in Exchange 2013 kann auch auf diesen Empfangsconnector über seine eindeutige GUID verwiesen werden. Wenn dem Empfangsconnector mit dem Namen "From the Internet" beispielsweise auch die GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3zugewiesen ist, können Sie den Empfangsconnector auch mit dem folgenden Befehl abrufen:

Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3

Platzhalterzeichen in "Identity"

Einige Get-Cmdlets können ein Platzhalterzeichen (*) als Teil des Werts akzeptieren, den Sie beim Ausführen des Cmdlets an Identity übermitteln. Mithilfe eines Wildcards mit dem Identity-Parameter können Sie einen partiellen Namen angeben und eine Liste von Objekten abrufen, die diesem Teilnamen entsprechen. Sie können ein Platzhalterzeichen am Anfang oder Am Ende des Werts Identity platzieren, aber Sie können das Zeichen nicht in der Mitte einer Zeichenfolge platzieren. Beispielsweise sind die Befehle Get-Mailbox David* und Get-Mailbox _anders* gültig, aber Get-Mailbox Reb*ca kein gültiger Befehl.

Einige Cmdlets vom Typ Get rufen Objekte in Exchange 2013 ab, die hierarchisch oder in Beziehungen aus übergeordneten und untergeordneten Objekten strukturiert sind. Das heißt, es kann eine Sammlung an übergeordneten Objekten geben, die auch ihre eigenen untergeordneten Objekte enthalten. Objekte mit einer übergeordneten und untergeordneten Beziehung können eine Identität mit der Syntax aufweisen <parent>\<child>.

Wenn ein Identity-Parameter über die Syntax verfügt <parent>\<child>, können Sie mithilfe einiger Cmdlets ein Platzhalterzeichen (*) verwenden, um alle oder einen Teil der übergeordneten oder untergeordneten Namen zu ersetzen. Wenn Sie beispielsweise alle untergeordneten Objekte mit dem Namen "Contoso" in allen übergeordneten Objekten suchen möchten, können Sie die Syntax "*\Contoso"verwenden. Wenn Sie alle untergeordneten Objekte mit dem partiellen Namen "Auth" suchen möchten, die unter dem "ServerA" übergeordneten Objekt vorhanden sind, können Sie die Syntax "ServerA\Auth*"verwenden.

Einige, wenn auch nicht alle, Cmdlets ermöglichen Ihnen bei der Ausführung eines Befehls die Angabe nur des untergeordneten Teils des Identity-Parameters. In diesem Fall setzen die Cmdlets das derzeit verwendete übergeordnete Objekt ein. Beispielsweise gibt es sowohl auf "MBX1" als auch auf "MBX2" einen Empfangsconnector namens "Contoso Receive Connector". Wenn Sie den Befehl Get-ReceiveConnector "Contoso Receive Connector" auf MBX2 ausführen, wird nur der Empfangsconnector auf dem Server MBX2 zurückgegeben.

Das jeweilige Verhalten des Parameters Identity und der Platzhalterzeichen hängt von dem ausgeführten Cmdlet ab. Weitere Informationen über das ausgeführte Cmdlet finden Sie im featurespezifischen Inhalt für das betreffende Cmdlet.

Beispiele für den Parameter "Identity"

Die in diesem Thema beschriebenen Beispiele veranschaulichen, wie der Identity-Parameter unterschiedliche eindeutige Werte akzeptieren kann, um auf bestimmte Objekte in der Exchange 2013-Organisation zu verweisen. Diese Beispiele zeigen auch, wie die Parameterbezeichnung Identity ausgelassen werden kann, um die Anzahl der Tastatureingaben beim Eingeben von Befehlen zu verringern.

DSN-Nachrichten

Die Beispiele in diesem Abschnitt beziehen sich auf die Benachrichtigungen über den Übermittlungsstatus (Delivery Status Notification, DSN), die in einer Exchange 2013-Organisation konfiguriert werden können. Das erste Beispiel zeigt, wie DSN 5.4.1 mithilfe des Cmdlets Get-SystemMessage abgerufen werden kann. Im Cmdlet Get-SystemMessage besteht der Identity-Parameter aus mehreren Datenteilen, die für jedes DSN-Nachrichtenobjekt konfiguriert sind. Diese Datenelemente umfassen die Sprache, in denen die Benachrichtigung geschrieben ist, ob der Bereich der Benachrichtigung intern oder extern ist, und den DSN-Nachrichtencode, wie im folgenden Beispiel gezeigt wird:

Get-SystemMessage en\internal\5.4.1

Sie können diese DSN-Nachricht auch mithilfe ihrer GUID abrufen, wie das folgende Beispiel zeigt, weil alle Objekte in Exchange 2013 eine GUID besitzen:

Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222

Weitere Informationen zur Zusammensetzung des Parameters Identity , wenn er mit den SystemMessage-Cmdlets verwendet wird, finden Sie unter DSN-Nachrichtenidentität.

Verwaltungsrolleneinträge

Die Beispiele in diesem Abschnitt beziehen sich auf Verwaltungsrolleneinträge, aus denen die Verwaltungsrollen in Exchange 2013 zusammengesetzt sind. Anhand von Verwaltungsrollen werden die Berechtigungen gesteuert, die Administratoren und Endbenutzern erteilt werden. Verwaltungsrolleneinträge bestehen aus zwei Teilen: der Verwaltungsrolle, der sie zugeordnet sind, und einem Cmdlet. Der Parameter Identity besteht ebenfalls sowohl aus dem Verwaltungsrollennamen als auch aus dem Namen des Cmdlets. Im Folgenden wird beispielsweise der Rolleneintrag für das Cmdlet Set-Mailbox für die Mail Recipients Rolle dargestellt:

Mail Recipients\Set-Mailbox

Der Mail Recipients\Set-Mailbox Rolleneintrag ist einer von mehreren Einträgen für die Mail Recipients Rolle. Um alle Rolleneinträge für die Mail Recipients Rolle anzuzeigen, können Sie den folgenden Befehl verwenden:

Get-ManagementRoleEntry "Mail Recipients\*"

Verwenden Sie den folgenden Befehl, um alle Rolleneinträge für die Mail Recipients Rolle anzuzeigen, die die Zeichenfolge "Mailbox" enthalten:

Get-ManagementRoleEntry "Mail Recipients\*Mailbox*"

Um alle Verwaltungsrollen anzeigen, die den Rolleneintrag Set-Mailbox enthalten, verwenden Sie den folgenden Befehl:

Get-ManagementRoleEntry *\Set-Mailbox

Mit Rolleneinträgen können Sie das Platzhalterzeichen vielfältig einsetzen, um die für Sie relevanten Informationen aus Exchange 2013 abzurufen.

Weitere Informationen zu Verwaltungsrollen finden Sie unter Grundlegendes zu Verwaltungsrollen.