Get-ManagementRoleEntry

Referenz

Modul:: ExchangePowerShell

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

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Get-ManagementRoleEntry, um für Verwaltungsrollen konfigurierte Verwaltungsrolleneinträge abzurufen.

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

Syntax

Get-ManagementRoleEntry
   [-Identity] <RoleEntryIdParameter>
   [-DomainController <Fqdn>]
   [-Parameters <String[]>]
   [-PSSnapinName <String>]
   [-Type <ManagementRoleEntryType[]>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-ManagementRoleEntry ruft Rolleneinträge ab, die für Rollen konfiguriert wurden. Sie können bestimmte Rolleneinträge abrufen, die bestimmten Kriterien entsprechen, z. B. Rollenname, Cmdletname, Parametername oder eine Kombination aus jedem Oder Rolleneintragstyp oder dem zugeordneten Windows PowerShell Snap-In.

Weitere Informationen zu Verwaltungsrolleneinträgen finden Sie unter Grundlegendes zu Verwaltungsrollen.

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-ManagementRoleEntry "Transport Rules\*"

In diesem Beispiel wird eine Liste aller Rolleneinträge für die Verwaltungsrolle "Transport Rules" abgerufen.

Beispiel 2

Get-ManagementRoleEntry *\Get-Recipient

In diesem Beispiel wird eine Liste aller Rolleneinträge abgerufen, die das Cmdlet Get-Recipient enthalten.

Beispiel 3

Get-ManagementRoleEntry "Tier 2 Help Desk\Set-Mailbox" | Format-List Name, Parameters, Role, Type

In diesem Beispiel wird der Rolleneintrag "Tier 2 Help Desk\Set-Mailbox" abgerufen, und die Ausgabe des Cmdlets Get-ManagementRoleEntry wird mittels Pipelining an das Cmdlet Format-List umgeleitet. Das cmdlet Format-List gibt dann nur die Eigenschaften Name, Parameters, Role und Type aus dem Rolleneintrag aus.

Parameter

-DomainController

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Type:	Fqdn
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

-Identity

Der Parameter Identity gibt den Rolleneintrag an, den Sie anzeigen möchten. Dieser Parameter verwendet die Syntax ( <management role>\<role entry name> z. B CustomRole\Set-Mailbox. ).

Weitere Informationen zur Funktionsweise von Verwaltungsrollen finden Sie unter Grundlegendes zu Verwaltungsrollen.

Sie können das Platzhalterzeichen (*) anstelle der Rolle, des Cmdlet-Namens oder beides verwenden.

Wenn der Rolleneintragsname Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Type:	RoleEntryIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Parameters

Der Parameter Parameters umfasst nur die Rolleneinträge, die die angegebenen Parameter enthalten. Mehrere Parameter können durch Kommata getrennt angegeben werden. Sie können das Platzhalterzeichen (*) mit Teilparameternamen verwenden, um alle Parameter abzurufen, die dem angegebenen Wert entsprechen.

Dieser Parameter ist hilfreich, wenn Sie das Platzhalterzeichen (*) mit dem im Parameter Identity angegebenen Wert verwenden.

Type:	String[]
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, Exchange Online, Exchange Online Protection

-PSSnapinName

Der PSSnapinName-Parameter gibt das Windows PowerShell Snap-In an, das den zurückzugebenden Rolleneintrag enthält. Verwenden Sie das Cmdlet Get-PSSnapin, um eine Liste der verfügbaren Windows PowerShell-Snap-Ins abzurufen.

Type:	String
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, Exchange Online, Exchange Online Protection

-Type

Der Parameter Type gibt den Typ des Rolleneintrags an, der zurückgegeben wird. Die gültigen Werte für den Type-Parameter sind eine beliebige Kombination der folgenden Parameter, die durch Kommas getrennt sind: Cmdlet, Script und ApplicationPermission.

Type:	ManagementRoleEntryType[]
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, Exchange Online, Exchange Online Protection

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.

Freigeben über