Kurzübersicht über die Exchange-Verwaltungsshell für Exchange 2013Exchange Management Shell quick reference for Exchange 2013

Gilt für: Exchange Server 2013Applies to: 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.This topic describes the most frequently used cmdlets available in the release to manufacturing (RTM) and later versions of Microsoft Exchange Server 2013 and provides examples of their use.

Hinweis

Weitere Inhalte zu anderen Bereichen von Exchange 2013 werden in Kürze zur Verfügung gestellt.More content will be added about other areas of Exchange 2013 soon.

Weitere Informationen zur Exchange-Verwaltungsshell in Exchange 2013 und allen verfügbaren Cmdlets finden Sie unter den folgenden Themen:For more information about the Exchange Management Shell in Exchange 2013 and all the available cmdlets, see the following topics:

Was möchten Sie erfahren?What would you like to learn about?

Allgemeine Cmdlet-AktionenCommon cmdlet actions

Die folgenden Verben werden von den meisten Cmdlets unterstützt und sind einer bestimmten Aktion zugeordnet.The following verbs are supported by most cmdlets and are associated with a specific action.

NewNew

Mit dem Verb New wird eine Instanz eines Elements erstellt, z. B. eine neue Konfigurationseinstellung, eine neue Datenbank oder ein neuer SMTP-Connector.The New verb creates an instance of something, such as a new configuration setting, a new database, or a new SMTP connector.

RemoveRemove

Mit dem Verb Remove wird eine Instanz eines Elements entfernt, z. B. ein Postfach oder eine Transportregel.The Remove verb removes an instance of something, such as a mailbox or transport rule.

Alle Remove-Cmdlets unterstützen die Parameter WhatIf und Confirm .All Remove cmdlets support the WhatIf and Confirm parameters. Weitere Informationen zu diesen Parametern finden Sie unter wichtige Parameter.For more information about these parameters, see Important Parameters.

EnableEnable

Mit dem Verb Enable wird eine Einstellung aktiviert oder ein Empfänger E-Mail-aktiviert.The Enable verb enables a setting or mail-enables a recipient.

DisableDisable

Mit dem Verb Disable wird eine Einstellung deaktiviert oder ein Empfänger E-Mail-deaktiviert.The Disable verb disables an enabled setting or mail-disables a recipient.

Alle Disable-Aufgaben unterstützen auch die Parameter WhatIf und Confirm .All Disable tasks also support the WhatIf and Confirm parameters. Weitere Informationen zu diesen Parametern finden Sie unter wichtige Parameter.For more information about these parameters, see Important Parameters.

SetSet

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.The Set verb modifies specific settings of an object, such as the alias of a contact or the deleted item retention of a mailbox database.

GetGet

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.The Get verb queries a specific object or a subset of a type of object, such as a specific mailbox, all mailbox users, or mailbox users in a domain.

Wichtige ParameterImportant parameters

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.The following parameters help you control how your commands run and indicate exactly what a command will do before it affects data.

IdentityIdentity

Der Parameter Identity gibt das eindeutige Objekt für den Vorgang an.The Identity parameter identifies the unique object for the task. Sie wird in der Regel mit Cmdlets für Enable, Disable, Remove, Sets und Get verwendet.It's typically used with Enable, Disable, Remove, Set, and Get cmdlets. Identity ist auch ein positioneller Parameter, was bedeutet, dass Sie beim Angeben des Parameters "Identity" in der Befehlszeile keine Identität angeben müssen.Identity is also a positional parameter, which means that you don't have to specify Identity when you specify the parameter's value on the command line.

Beispielsweise führt Get-Mailbox -Identity user1 eine Abfrage des Postfachs von user1 aus. Get-Mailbox user1 entspricht Get-Mailbox -Identity user1.For example, Get-Mailbox -Identity user1 queries for the mailbox of user1. Get-Mailbox user1 is equivalent to Get-Mailbox -Identity user1.

WhatIfWhatIf

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 lautet $true.The WhatIf parameter instructs the cmdlet to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without actually applying any of the changes. The default value is $true.

ConfirmConfirm

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 lautet $true.The Confirm parameter causes the cmdlet to pause processing and requires the administrator to acknowledge what the cmdlet will do before processing continues. The default value is $true.

ValidierenValidate

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.The Validate parameter causes the cmdlet to check that all prerequisites for running the operation are satisfied and that the operation will complete successfully.

Tipps und TricksTips and tricks

Die folgenden Befehle sind verschiedenen Tasks zugeordnet, die Sie beim Verwalten von Exchange 2013 nutzen können.The following commands are associated with various tasks that you can use when administering Exchange 2013.

Get-CommandGet-Command

Dieses Cmdlet ruft alle Tasks ab, die in Exchange 2013 ausgeführt werden können.This cmdlet retrieves all tasks that can be executed in Exchange 2013.

Get-Command *-Schlüsselwort*Get-Command *keyword*

Dieses Cmdlet ruft Tasks ab, bei denen der Cmdlet-Name das Schlüsselwort enthält.This cmdlet retrieves tasks that have keyword in the cmdlet.

Get-Task | Get-MemberGet-task | Get-Member

Dieses Cmdlet ruft alle Eigenschaften und Methoden von Task ab.This cmdlet retrieves all properties and methods of task.

Get-Task | Format-ListGet-task | Format-List

Dieses Cmdlet zeigt die Ausgabe der Abfrage in einer formatierten Liste an.This cmdlet displays the output of the query in a formatted list. Sie können die Ausgabe aller Get-Cmdlets an Format-List übergeben, um die gesamte Gruppe von Eigenschaften anzuzeigen, die für das von diesem Befehl zurückgegebene Objekt vorhanden sind, oder Sie können einzelne Eigenschaften angeben, die durch Kommas getrennt angezeigt werden sollen, wie im folgenden Beispiel dargestellt. : Get-Postfach *John* | Format-List Alias, \* QuotaYou can pipe the output of any Get cmdlet to Format-List to view the whole set of properties that exist on the object returned by that command, or you can specify individual properties that you want to view, separated by commas, as in the following example: Get-Mailbox *john* | Format-List alias,\*quota

Help TaskHelp task

Dieses Cmdlet ruft Exchange-Verwaltungsshell Hilfeinformationen für eine beliebige Aufgabe in Exchange 2013 ab, wie im folgenden Beispiel: Help Get-MailboxThis cmdlet retrieves Exchange Management Shell help information for any task in Exchange 2013, as in the following example: Help Get-Mailbox

Get-Task | Format-List > file. txtGet-task | Format-List > file.txt

Dieses Cmdlet exportiert die Ausgabe von Task in eine Textdatei: Datei.txtThis cmdlet exports the output of task to a text file: file.txt

BerechtigungenPermissions

Get-RoleGroupMember "- Organisationsverwaltung"Get-RoleGroupMember "Organization Management"

Mit diesem Befehl werden die Mitglieder der Verwaltungsrollengruppe " Organisationsverwaltung " abgerufen.This command retrieves the members of the Organization Management management role group.

Get-ManagementRoleAssignment-Rolle "– e-Mail-Empfänger Erstellung " – GetEffectiveUsersGet-ManagementRoleAssignment -Role "Mail Recipient Creation" -GetEffectiveUsers

Mit diesem Befehl wird eine Liste aller Benutzer abgerufen, denen die Berechtigungen erteilt werden, die von der Verwaltungsrolle "e-Mail-Empfänger Erstellung" bereitgestellt werden.This command retrieves a list of all the users who are granted permissions provided by the Mail Recipient Creation management role. 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.This includes users who are members of role groups or universal security groups (USGs) that are assigned the Mail Recipient Creation role. Es werden keine Benutzer aufgeführt, die Mitglieder verknüpfter Rollengruppen in einer anderen Gesamtstruktur sind.This doesn't include users who are members of linked role groups in another forest.

Get-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntryGet-ManagementRoleAssignment -RoleAssignee Administrator | Get-ManagementRole | Get-ManagementRoleEntry

Mit diesem Befehl wird eine Liste der Cmdlets abgerufen, die der Benutzer Administrator ausführen kann.This command retrieves a list of cmdlets that the user Administrator can run.

ForEach ($RoleEntry in Get-ManagementRoleEntry \* \Remove-Mailbox -Parameters Identity) {Get-ManagementRoleAssignment-Role $RoleEntry. Role-GetEffectiveUsers-Delegating $false | Where-Object {$ _. EffectiveUserName-ne "alle Gruppenmitglieder"} | FL-Rolle, EffectiveUserName, AssignmentChain}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.This command retrieves a list of all the users who can run the Remove-Mailbox cmdlet.

Get-ManagementRoleAssignment -WritableRecipient kima -GetEffectiveUsers | FT RoleAssigneeName, EffectiveUserName, Role, AssignmentChainGet-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.This command retrieves a list of all users who can modify the mailbox of kima.

New-ManagementScope " Seattle users " -RecipientRestrictionFilter { City -EQ " Seattle " }New-ManagementScope "Seattle Users" -RecipientRestrictionFilter { City -Eq "Seattle" }

New-RoleGroup " Seattle Admins " -Rollen " e-Mail-Empfänger", " Erstellung"von e-Mail-Empfängern, " Post Fach Import Export",- CustomRecipientWriteScope "- Benutzer in 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.This command creates a new management scope and management role group to enable members of the role group to manage recipients in Seattle.

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.First, the Seattle Users management scope is created, which matches only recipients who have Seattle in the City attribute on their user object.

Anschließend wird eine neue Rollengruppe namens " Seattle Admins " erstellt, und die Rollen " e-Mail-Empfänger", "e-Mail-Empfänger" und " Post Fach Import exportieren " werden zugewiesen.Then, a new role group called Seattle Admins is created and the Mail Recipients, Mail Recipient Creation, and Mailbox Import Export roles are assigned. Der Bereich der Rollengruppe ist so festgelegt, dass ihre Mitglieder nur Benutzer verwalten können, die dem Empfängerfilterbereich Seattle Users entsprechen.The role group is scoped so that its members can manage only users who match the Seattle Users recipient filter scope.

New-ManagementScope " Vancouver Servers " -ServerRestrictionFilter { deren -EQ " Vancouver " }New-ManagementScope "Vancouver Servers" -ServerRestrictionFilter { ServerSite -Eq "Vancouver" }

$RoleGroup = Get-RoleGroup "- Server Verwaltung"$RoleGroup = Get-RoleGroup "Server Management"

New-RoleGroup " Vancouver Server Management " -Roles $RoleGroup. Roles "-CustomConfigWriteScope Vancouver Servers"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.This command creates a new management scope and copies an existing role group to enable members of the new role group to manage only servers in the Vancouver Active Directory site.

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.First, the Vancouver Servers management scope is created, which matches only servers that are located in the Vancouver Active Directory site. The Active Directory site is stored in the ServerSite attribute on the server objects.

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.Then, a new role group called Vancouver Server Management is created that's a copy of the Server Management role group. This new role group, however, is scoped to allow its members to manage only servers that match the Vancouver Servers configuration filter scope.

Add-RoleGroupMember "- Organisationsverwaltung " – Mitglied DavidsAdd-RoleGroupMember "Organization Management" -Member davids

Mit diesem Befehl wird der Benutzer davids zur Rollengruppe Organisationsverwaltung hinzugefügt.This command adds the user davids to the Organization Management role group.

Get-ManagementRoleAssignment-role " Mail Recipient Creation " -RoleAssignee " Seattle Admins " | Remove-ManagementRoleAssignmentGet-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.This command removes the Mail Recipient Creation role from the Seattle Admins role group. This command is useful because you don't need to know the name of the management role assignment that assigns the role to the role group.

RemoteshellRemote Shell

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

Import-PSSession $SessionImport-PSSession $Session

Diese Befehle öffnen eine neue Remoteshell-Sitzung zwischen einem lokalen Computer mit Domänenbeitritt und einem Remote Exchange 2013 Server mit dem FQDN ExServer.contoso.com.These commands open a new remote Shell session between a local domain-joined computer and a remote Exchange 2013 server with the 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.Use this command if you want to administer a remote Exchange 2013 server and only have the Windows Management Framework, which includes the Windows PowerShell command-line interface, installed on your local computer. Dieser Befehl verwendet Ihre aktuellen Anmeldeinformationen für die Authentifizierung beim Exchange 2013-Remoteserver.This command uses your current logon credentials to authenticate against the remote Exchange 2013 server.

$UserCredential = Get-Credential$UserCredential = Get-Credential

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

Import-PSSession $SessionImport-PSSession $Session

Diese Befehle öffnen eine neue Remoteshell-Sitzung zwischen einem lokalen Computer mit Domänenbeitritt und einem Remote Exchange 2013 Server mit dem FQDN ExServer.contoso.com.These commands open a new remote Shell session between a local domain-joined computer and a remote Exchange 2013 server with the 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 Windows PowerShell umfasst.Use this command if you want to administer a remote Exchange 2013 server and only have the Windows Management Framework, which includes Windows PowerShell, installed on your local computer. Dieser Befehl verwendet die von Ihnen angegebenen Anmeldeinformationen für die Authentifizierung beim Exchange 2013-Remoteserver.This command uses credentials you specify explicitly to authenticate against the remote Exchange 2013 server.

Remove-PSSession $SessionRemove-PSSession $Session

Mit diesem Befehl wird die Remoteshellsitzung zwischen einem lokalen Computer und dem Exchange 2013-Remoteserver beendet.This command closes the remote Shell session between a local computer and the remote Exchange 2013 server.

Import-RecipientDataProperty-Identity "Tony Smith" -Spoken Name-FileData ([Byte []] $ (Get-Content- "Path" M:\AudioFiles\TonySmith.WMA-Encoding Byte-readCount 0))Import-RecipientDataProperty -Identity "Tony Smith" -SpokenName -FileData ([Byte[]]$(Get-Content -Path "M:\AudioFiles\TonySmith.wma" -Encoding Byte -ReadCount 0))

Dieser Befehl zeigt ein Beispiel für die in Kursivschrift dargestellte Syntax, die erforderlich ist, um eine Datei in einen Remote Exchange 2013 Server mit dem FileData-Parameter eines Cmdlets zu importieren.This command shows an example of the syntax, shown in italics, required to import a file into a remote Exchange 2013 server using the FileData parameter on a cmdlet. Die Syntax kapselt die in der M:\AudioFiles\TonySmith.WMA -Datei enthaltenen Daten und strömt die Daten in die FileData-Eigenschaft des Import-RecipientDataProperty-Cmdlets.The syntax encapsulates the data contained in the M:\AudioFiles\TonySmith.wma file and streams the data to the FileData property on the Import-RecipientDataProperty cmdlet.

Der Parameter FileData akzeptiert bei Verwendung dieser Syntax für die meisten Cmdlets Daten aus einer Datei auf Ihrem lokalen Computer.The FileData parameter accepts data from a file on your local computer using this syntax on most cmdlets.

Export-RecipientDataProperty-Identity Tony@contoso.com-Spoken | ForEach {$ _. FileData | Add-Content-C:\tonysmith.WMA-Encoding Byte}Export-RecipientDataProperty -Identity tony@contoso.com -SpokenName | ForEach {$_.FileData | Add-Content C:\tonysmith.wma -Encoding Byte}

Dieser Befehl zeigt ein Syntaxbeispiel, dargestellt in Kursivformatierung, das zum Exportieren einer Datei von einem Exchange 2013-Remoteserver erforderlich ist.This command shows an example of the syntax, shown in italics, required to export a file from a remote Exchange 2013 server. Die Syntax kapselt die in der Eigenschaft FileData des vom Cmdlet zurückgegebenen Objekts gespeicherten Daten und streamt die Daten auf Ihren lokalen Computer.The syntax encapsulates the data stored in the FileData property on the object returned by the cmdlet and then streams the data to your local computer. Die Daten werden dann in der C:\tonysmith.WMA -Datei gespeichert.The data is then stored in the C:\tonysmith.wma file.

Die meisten Cmdlets, die Objekte mit einer Eigenschaft FileData ausgeben, verwenden diese Syntax zum Exportieren von Daten in eine Datei auf Ihrem lokalen Computer.Most cmdlets that output objects with a FileData property use this syntax to export data to a file on your local computer.