Kurzübersicht über die Exchange-Verwaltungsshell für Exchange 2013

Gilt für: Exchange Server 2013

In diesem Thema werden die am häufigsten verwendeten Cmdlets beschrieben, die in der RTM-Version (Release to Manufacturing) und höheren Versionen von Microsoft Exchange Server 2013 verfügbar sind, und es werden Beispiele zu deren Verwendung bereitgestellt.

Hinweis

Weitere Inhalte zu anderen Bereichen von Exchange 2013 werden in Kürze zur Verfügung gestellt.

Weitere Informationen zur Exchange-Verwaltungsshell in Exchange 2013 und allen verfügbaren Cmdlets finden Sie unter den folgenden Themen:

Was möchten Sie erfahren?

Allgemeine Cmdlet-Aktionen

Die folgenden Verben werden von den meisten Cmdlets unterstützt und sind einer bestimmten Aktion zugeordnet.

Verb Beschreibung
Neu Mit dem Verb New wird eine Instanz eines Elements erstellt, z. B. eine neue Konfigurationseinstellung, eine neue Datenbank oder ein neuer SMTP-Connector.
Remove Mit dem Verb Remove wird eine Instanz eines Elements entfernt, z. B. ein Postfach oder eine Transportregel.

Alle Remove-Cmdlets unterstützen die Parameter WhatIf und Confirm . Weitere Informationen zu diesen Parametern finden Sie unter Wichtige Parameter.
Aktivieren Mit dem Verb Enable wird eine Einstellung aktiviert oder ein Empfänger E-Mail-aktiviert.
Disable Mit dem Verb Disable wird eine Einstellung deaktiviert oder ein Empfänger E-Mail-deaktiviert.

Alle Aufgaben zum Deaktivieren unterstützen auch die Parameter WhatIf und Confirm . Weitere Informationen zu diesen Parametern finden Sie unter Wichtige Parameter.
Satz Mit dem Verb Set werden bestimmte Einstellungen eines Objekts bearbeitet, z. B. der Alias eines Kontakts oder die Aufbewahrungszeit für gelöschte Elemente einer Postfachdatenbank.
Get Mit dem Verb Get wird die Abfrage eines bestimmten Objekts oder einer Teilmenge eines Objekttyps ausgeführt, z. B. eines bestimmten Postfachs, aller Postfachbenutzer oder von Postfachbenutzern in einer Domäne.

Wichtige Parameter

Die folgenden Parameter unterstützen Sie bei der Steuerung der Befehlsausführung und liefern genaue Angaben über die Auswirkungen eines Befehls, bevor Daten geändert werden.

Parameter Beschreibung
Identität Der Identity-Parameter identifiziert das eindeutige Objekt für die Aufgabe. Sie wird in der Regel mit den Cmdlets Enable, Disable, Remove, Set und Get verwendet. Identity ist auch ein Positionsparameter, was bedeutet, dass Sie identity nicht angeben müssen , wenn Sie den Wert des Parameters in der Befehlszeile angeben.

Beispielsweise führt Get-Mailbox -Identity user1 eine Abfrage des Postfachs von user1 aus. Get-Mailbox user1 entspricht Get-Mailbox -Identity user1.
Whatif Der Parameter WhatIf weist das Cmdlet an, die für das Objekt auszuführenden Aktionen lediglich zu simulieren. Durch Verwendung des Parameters WhatIf können Sie die sich ergebenden Änderungen anzeigen, ohne diese Änderungen tatsächlich anzuwenden. Der Standardwert ist $true.
Bestätigen Der Parameter Confirm führt dazu, dass das Cmdlet die Verarbeitung unterbricht und vom Administrator die Bestätigung der Cmdlet-Aktion anfordert, bevor die Verarbeitung fortgesetzt wird. Der Standardwert ist $true.
Validieren Der Parameter Validate führt dazu, dass das Cmdlet überprüft, ob alle Voraussetzungen zur Ausführung des Vorgangs erfüllt sind und der Vorgang erfolgreich abgeschlossen wird.

Tipps und Tricks

Die folgenden Befehle sind verschiedenen Tasks zugeordnet, die Sie beim Verwalten von Exchange 2013 nutzen können.

Cmdlet Beschreibung
Get-Command Dieses Cmdlet ruft alle Tasks ab, die in Exchange 2013 ausgeführt werden können.
Get-Command *keyword* Dieses Cmdlet ruft Tasks ab, bei denen der Cmdlet-Name das Schlüsselwort enthält.
Get-Task | Get-Member Dieses Cmdlet ruft alle Eigenschaften und Methoden von Task ab.
Get-Task | Format-List Dieses Cmdlet zeigt die Ausgabe der Abfrage in einer formatierten Liste an. Sie können die Ausgabe eines get-Cmdlets an Format-List übergeben, um den gesamten Satz von Eigenschaften anzuzeigen, die für das von diesem Befehl zurückgegebene Objekt vorhanden sind, oder Sie können einzelne Eigenschaften angeben, die Sie anzeigen möchten, getrennt durch Kommas, wie im folgenden Beispiel: Get-Mailbox john | Format-List alias,*quota*.
Help Task Dieses Cmdlet ruft Hilfeinformationen der Exchange-Verwaltungsshell für jede Aufgabe in Exchange 2013 ab, wie im folgenden Beispiel gezeigt: Help Get-Mailbox.
Get-Task | Format-List > file.txt Dieses Cmdlet exportiert die Ausgabe von Task in eine Textdatei: file.txt

Berechtigungen

Befehl Beschreibung
Get-RoleGroupMember "Organization Management" Dieser Befehl ruft die Mitglieder der Rollengruppe Organisationsverwaltung ab.
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers Dieser Befehl ruft eine Liste aller Benutzer ab, denen berechtigungen erteilt werden, die von der Verwaltungsrolle "E-Mail-Empfängererstellung " bereitgestellt werden. Dies schließt Benutzer ein, die Mitglieder von Rollengruppen oder universellen Sicherheitsgruppen (Universal Security Group, USG) sind, denen die Rolle Erstellung von E-Mail-Empfängern zugewiesen ist. Es werden keine Benutzer aufgeführt, die Mitglieder verknüpfter Rollengruppen in einer anderen Gesamtstruktur sind.
Get-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntry Mit diesem Befehl wird eine Liste der Cmdlets abgerufen, die der Benutzer Administrator ausführen kann.
ForEach ($RoleEntry in Get-ManagementRoleEntry *Remove-Mailbox -Parameters Identity) {Get-ManagementRoleAssignment -Role $RoleEntry.Role -GetEffectiveUsers -Delegating $False | Where-Object {$_.EffectiveUserName -Ne "All Group Members"} | FL Role, EffectiveUserName, AssignmentChain} Mit diesem Befehl wird eine Liste aller Benutzer abgerufen, die das Cmdlet Remove-Mailbox ausführen können.
Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChain Mit diesem Befehl wird eine Liste aller Benutzer abgerufen, die das Postfach von kima ändern können.
New-ManagementScope "Seattle Users" -RecipientRestrictionFilter "City -Eq 'Seattle'"

New-RoleGroup "Seattle Admins" -Roles "Mail Recipients", "Mail Recipient Creation", "Mailbox Import Export", -CustomRecipientWriteScope "Seattle Users"
Mit diesem Befehl werden ein neuer Verwaltungsbereich sowie eine Verwaltungsrollengruppe erstellt, um Mitgliedern der Rollengruppe die Verwaltung von Empfängern in Seattle zu ermöglichen.

Zunächst wird der Verwaltungsbereich Seattle Users erstellt, der nur Empfänger einschließt, für die im Attribut City des zugehörigen Benutzerobjekts der Wert Seattle angegeben ist.

Anschließend wird eine neue Rollengruppe namens Seattle Admins erstellt, und die Rollen E-Mail-Empfänger, E-Mail-Empfängererstellung und Postfachimportexport werden zugewiesen. Der Bereich der Rollengruppe ist so festgelegt, dass ihre Mitglieder nur Benutzer verwalten können, die dem Empfängerfilterbereich Seattle Users entsprechen.
New-ManagementScope "Vancouver Servers" -ServerRestrictionFilter "ServerSite -Eq 'Vancouver'"

$RoleGroup = Get-RoleGroup "Server Management" <br/><br/> New-RoleGroup "Vancouver Server Management" -Roles $RoleGroup.Roles -CustomConfigWriteScope "Vancouver Servers"
Mit diesem Befehl wird ein neuer Verwaltungsbereich erstellt und eine vorhandene Rollengruppe kopiert, um Mitgliedern der neuen Rollengruppe ausschließlich das Verwalten von Server am Active Directory-Standort Vancouver zu ermöglichen.

Zunächst wird der Verwaltungsbereich Vancouver Servers erstellt, der nur Server umfasst, die sich am Active Directory-Standort Vancouver befinden. Der Active Directory-Standort wird im Attribut ServerSite der Serverobjekte angegeben.

Anschließend wird eine neue Rollengruppe namens Vancouver Server Management erstellt, bei der es sich um eine Kopie der Rollengruppe Serververwaltung handelt. Diese neue Rollengruppe wird jedoch so konfiguriert, dass ihre Mitglieder nur die Server verwalten können, die dem Empfängerfilterbereich Vancouver Servers entsprechen.
Add-RoleGroupMember "Organization Management" -Member davids Mit diesem Befehl wird der Benutzer davids zur Rollengruppe Organisationsverwaltung hinzugefügt.
Get-ManagementRoleAssignment -Role "Mail Recipient Creation" -RoleAssignee "Seattle Admins" | Remove-ManagementRoleAssignment Mit diesem Befehl wird die Rolle Erstellung von E-Mail-Empfängern aus der Rollengruppe Seattle Admins entfernt. Dieser Befehl ist nützlich, da Sie den Namen der Verwaltungsrollenzuweisung nicht kennen müssen, mit welcher die Rolle zur Rollengruppe zugewiesen wird.

Remoteshell

Befehl Beschreibung
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos

Import-PSSession $Session
Diese Befehle öffnen eine neue Remoteshellsitzung zwischen einem in die Domäne eingebundenen lokalen Computer und einem Exchange 2013-Remoteserver mit dem FQDN ExServer.contoso.com. Verwenden Sie diesen Befehl, wenn Sie einen Exchange 2013-Remoteserver verwalten möchten und auf Ihrem lokalen Computer nur das Windows Management Framework installiert ist, das die Windows PowerShell-Befehlszeilenschnittstelle umfasst. Dieser Befehl verwendet Ihre aktuellen Anmeldeinformationen für die Authentifizierung beim Exchange 2013-Remoteserver.
$UserCredential = Get-Credential

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri http://ExServer.contoso.com/PowerShell/ -Authentication Kerberos -Credential $UserCredential

Import-PSSession $Session
Mit diesen Befehlen wird eine neue Remoteshellsitzung zwischen einem in die Domäne eingebundenen lokalen Computer und einem Exchange 2013-Remoteserver mit dem FQDN ExServer.contoso.com geöffnet. Verwenden Sie diesen Befehl, wenn Sie einen Exchange 2013-Remoteserver verwalten möchten und auf Ihrem lokalen Computer nur das Windows Management Framework installiert ist, das Windows PowerShell umfasst. Dieser Befehl verwendet die von Ihnen angegebenen Anmeldeinformationen für die Authentifizierung beim Exchange 2013-Remoteserver.
Remove-PSSession $Session Mit diesem Befehl wird die Remoteshellsitzung zwischen einem lokalen Computer und dem Exchange 2013-Remoteserver beendet.
Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([System.IO.File]::ReadAllBytes('M:\AudioFiles\TonySmith.wma')) Dieser Befehl zeigt ein Beispiel für die Syntax, die zum Importieren einer Datei in einen Exchange 2013-Remoteserver mithilfe des FileData-Parameters in einem Cmdlet erforderlich ist. Die Syntax kapselt die in der Datei M:\AudioFiles\TonySmith.wma enthaltenen Daten und streamt die Daten an die FileData-Eigenschaft im cmdlet Import-RecipientDataProperty.

Der FileData-Parameter akzeptiert Daten aus einer Datei auf Ihrem lokalen Computer mithilfe dieser Syntax für die meisten Cmdlets.
$SN = Export-RecipientDataProperty -Identity tonys@contoso.com -SpokenName

[System.IO.File]::WriteAllBytes('C:\tonysmith.wma', $SN.FileData)

Dieser Befehl zeigt ein Beispiel für die Syntax, die zum Exportieren einer Datei von einem Exchange 2013-Remoteserver erforderlich ist. Die Syntax kapselt die in der Eigenschaft FileData des vom Cmdlet zurückgegebenen Objekts gespeicherten Daten und streamt die Daten auf Ihren lokalen Computer. Die Daten werden dann in der Datei C:\tonysmith.wma gespeichert.

Die meisten Cmdlets, die Objekte mit einer Eigenschaft FileData ausgeben, verwenden diese Syntax zum Exportieren von Daten in eine Datei auf Ihrem lokalen Computer.