New-RoleGroup

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 New-RoleGroup-Cmdlet, um Verwaltungsrollengruppen zu erstellen.

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

Syntax

New-RoleGroup
   [-Name] <String>
   -LinkedDomainController <String>
   -LinkedForeignGroup <UniversalSecurityGroupIdParameter>
   [-LinkedCredential <PSCredential>]
   [-Confirm]
   [-CustomConfigWriteScope <ManagementScopeIdParameter>]
   [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
   [-Description <String>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Force]
   [-ManagedBy <MultiValuedProperty>]
   [-Members <MultiValuedProperty>]
   [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
   [-Roles <RoleIdParameter[]>]
   [-SamAccountName <String>]
   [-WellKnownObject <String>]
   [-WhatIf]
   [<CommonParameters>]
New-RoleGroup
   [-Name] <String>
   [-Confirm]
   [-CustomConfigWriteScope <ManagementScopeIdParameter>]
   [-CustomRecipientWriteScope <ManagementScopeIdParameter>]
   [-Description <String>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-Force]
   [-Id <Guid>]
   [-ManagedBy <MultiValuedProperty>]
   [-Members <MultiValuedProperty>]
   [-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
   [-Roles <RoleIdParameter[]>]
   [-SamAccountName <String>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Sie müssen der Rollengruppe keine Mitglieder hinzufügen oder Verwaltungsrollen zuordnen, wenn Sie die Rollengruppe erstellen. Jedoch erhalten Benutzer erst Berechtigungen, wenn Sie der Rollengruppe Mitglieder hinzufügen oder Rollen zuordnen. Sie können auch eine benutzerdefinierte Konfiguration oder Empfängerbereiche angeben, wenn Sie eine Rollengruppe erstellen. Diese Bereiche werden auf erstellte Verwaltungsrollenzuweisungen angewendet, wenn die Rollengruppe erstellt wird.

Wenn Sie eine Rollengruppe erstellen, können Sie die Gruppe erstellen und direkt Mitglieder hinzufügen, oder Sie können eine verknüpfte Rollengruppe erstellen. Eine verknüpfte Rollengruppe verknüpft die Rollengruppe mit einer universellen Sicherheitsgruppe (UNIVERSAL Security Group, USG) in einer anderen Gesamtstruktur. Das Erstellen einer verknüpften Rollengruppe ist nützlich, wenn sich Ihre Server, auf denen Exchange ausgeführt wird, in einer Ressourcengesamtstruktur befinden und sich Ihre Benutzer und Administratoren in einer separaten Benutzergesamtstruktur befinden. Wenn Sie eine verknüpfte Rollengruppe erstellen, können Sie ihr nicht direkt Mitglieder hinzufügen. Sie müssen die Mitglieder der USG in der fremden Gesamtstruktur hinzufügen.

Weitere Informationen zu Rollengruppen finden Sie unter Grundlegendes zu Verwaltungsrollengruppen.

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

New-RoleGroup -Name "Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members Kim, Martin

In diesem Beispiel wird eine Rollengruppe erstellt. Der Rollengruppe werden die Rollen "Mail Recipients" und "Mail Enabled Public Folders" zugewiesen, und die Benutzer "Kim" und "Martin" werden als Mitglieder hinzugefügt. Da keine Bereiche angegeben wurden, können "Kim" und "Martin" jeden Empfänger verwalten und Kennwörter für alle Benutzer in der Organisation zurücksetzen.

Beispiel 2

New-RoleGroup -Name "Seattle Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members John, Carol -CustomRecipientWriteScope "Seattle Recipients"

In diesem Beispiel wird eine Rollengruppe mit einem benutzerdefinierten Empfängerbereich erstellt. Der benutzerdefinierte Empfängerbereich "Seattle Recipients" beschränkt den Bereich der Rollen, die der Rollengruppe zugewiesen wurden, auf Empfänger, die ihre Eigenschaft City auf "Seattle" festgelegt haben. Der Rollengruppe werden die Rollen "Mail Recipients" und "Mail Enabled Public Folders" zugewiesen, und die Benutzer "John" und "Carol" werden als Mitglieder hinzugefügt.

Beispiel 3

New-RoleGroup -Name "Transport Rules Management" -Roles "Transport Rules" -Members "Compliance Group" -ManagedBy Isabel

In diesem Beispiel wird eine Rollengruppe erstellt, und "Isabel" kann Mitglieder zu einer Rollengruppe hinzufügen oder Mitglieder aus einer Rollengruppe entfernen, indem sie der Eigenschaft ManagedBy hinzugefügt wird. Der Rollengruppe wird die Rolle "Transport Rules" zugewiesen, und die universelle Sicherheitsgruppe "Compliance Group" wird als Mitglied hinzugefügt.

Beispiel 4

$Credentials = Get-Credential

New-RoleGroup -Name "ContosoUsers: Toronto Recipient Admins" -LinkedDomainController dc02.contosousers.contoso.com -LinkedCredential $Credentials -LinkedForeignGroup "Toronto Administrators" -CustomRecipientWriteScope "Toronto Recipients" -Roles "Mail Recipients"

In diesem Beispiel wird eine verknüpfte Rollengruppe erstellt, mit der die Mitglieder der universellen Sicherheitsgruppe "Toronto Administrators" in der Benutzergesamtstruktur "Contoso" Empfänger in Toronto verwalten können. Der benutzerdefinierte Empfängerbereich "Toronto Recipients" beschränkt den Bereich der Rollen, die der Rollengruppe zugewiesen wurden, auf Empfänger, die ihre Eigenschaft City auf "Toronto" festgelegt haben. Der Rollengruppe wird die Rolle "Mail Recipients" zugewiesen.

Der erste Befehl ruft die Anmeldeinformationen mithilfe des Cmdlets Get-Credential ab und speichert sie in der variablen $Credentials. Anschließend wird die verknüpfte Rollengruppe mit dem zweiten Befehl erstellt.

Beispiel 5

$RoleGroup = Get-RoleGroup "Recipient Management"

New-RoleGroup "Limited Recipient Management" -Roles $RoleGroup.Roles

In diesem Beispiel werden die Rollen einer vorhandenen Rollengruppe in eine neue benutzerdefinierte Rollengruppe kopiert. Dies kann sinnvoll sein, wenn Sie eine Rollengruppe erstellen möchten, die mit einer vorhandenen Rollengruppe vergleichbar ist, die Rollenzuweisungen jedoch nicht manuell erstellen möchten. Möglicherweise möchten Sie z. B. eine Rollengruppe erstellen, welche die meisten, jedoch nicht alle Verwaltungsrollen der Rollengruppe "Recipient Management" enthält.

Der erste Befehl speichert die vorhandene Rollengruppe in einer Variablen, und der zweite Befehl erstellt die benutzerdefinierte Rollengruppe.

In diesem Beispiel werden Variablen zum Speichern von Informationen verwendet. Weitere Informationen zu Variablen finden Sie unter Informationen zu Variablen.

Beispiel 6

Remove-ManagementRoleAssignment "Distribution Groups-Limited Recipient Management"

In diesem Beispiel wird die Rollenzuweisung zwischen der Verwaltungsrolle "Verteilergruppen" und der Rollengruppe "Eingeschränkte Empfängerverwaltung" entfernt, die Sie im vorherigen Beispiel erstellt haben.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
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, Security & Compliance, Exchange Online Protection

-CustomConfigWriteScope

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter CustomConfigWriteScope gibt den vorhandenen konfigurationsbasierten Verwaltungsbereich an, der diesen mit dieser Rollengruppe erstellten Verwaltungsrollenzuweisungen zugewiesen werden soll. Wenn der Name des Verwaltungsbereichs Leerzeichen enthält, setzen Sie ihn in Anführungszeichen ("). Verwenden Sie das Cmdlet Get-ManagementScope, um eine Liste vorhandener Verwaltungsbereiche abzurufen.

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

-CustomRecipientWriteScope

Der Parameter CustomRecipientWriteScope gibt den vorhandenen empfängerbasierten Verwaltungsbereich an, der diesen mit dieser Rollengruppe erstellten Verwaltungsrollenzuweisungen zugewiesen werden soll. Wenn der Name des Verwaltungsbereichs Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Verwenden Sie das Cmdlet Get-ManagementScope, um eine Liste vorhandener Verwaltungsbereiche abzurufen.

Bei Verwendung des Parameters CustomRecipientWriteScope kann der Parameter RecipientOrganizationalUnitScope nicht verwendet werden.

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

-Description

Der Parameter Description gibt die Beschreibung an, die beim Anzeigen der Rollengruppe mithilfe des Cmdlets Get-RoleGroup angezeigt wird. Schließen Sie die Beschreibung in Anführungszeichen (") ein.

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, Security & Compliance, Exchange Online Protection

-DisplayName

Der Parameter DisplayName gibt den Anzeigenamen der Rollengruppe an. Wenn der Name Leerzeichen enthält, setzen Sie ihn in Anführungszeichen ("). Dieser Parameter hat eine maximale Länge von 256 Zeichen.

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, Security & Compliance, Exchange Online Protection

-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

-Force

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection

-Id

Dieser Parameter ist nur in PowerShell für Sicherheitskonformität & verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-LinkedCredential

Dieser Parameter ist im lokalen Exchange verfügbar.

Der LinkedCredential-Parameter gibt den Benutzernamen und das Kennwort an, die für den Zugriff auf den durch den LinkedDomainController-Parameter angegebenen Domänencontroller verwendet werden.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

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

-LinkedDomainController

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter LinkedDomainController gibt den vollständig qualifizierten Domänennamen (FQDN) oder die IP-Adresse des Domänencontrollers in der Gesamtstruktur an, in der sich die fremde universelle Sicherheitsgruppe befindet. Der von Ihnen angegebene Domänencontroller wird zum Abrufen von Sicherheitsinformationen für die durch den Parameter LinkedForeignGroup angegebene fremde universelle Sicherheitsgruppe verwendet.

Wenn Sie den LinkedDomainController-Parameter verwenden, müssen Sie mit dem Parameter LinkedForeignGroup eine fremde USG angeben, und Sie können den Members-Parameter nicht verwenden.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LinkedForeignGroup

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter LinkedForeignGroup gibt den Namen der fremden universellen Sicherheitsgruppe an, mit der Sie diese Rollengruppe verknüpfen möchten. Wenn der Name der fremden universellen Sicherheitsgruppe Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Wenn Sie den Parameter LinkedForeignGroup verwenden, müssen Sie einen Domänencontroller im LinkedDomainController-Parameter angeben, und Sie können den Members-Parameter nicht verwenden.

Type:UniversalSecurityGroupIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ManagedBy

Der Parameter ManagedBy gibt die Benutzer oder universellen Sicherheitsgruppen an, die die Konfiguration einer Rollengruppe ändern können oder Mitglieder zu einer Rollengruppe hinzufügen oder Mitglieder aus einer Rollengruppe entfernen können.

Sie können den Namen, den Distinguished Name (DN) oder die primäre SMTP-Adresse des Benutzers oder der USG, die Sie hinzufügen möchten, verwenden. Wenn der Name des Benutzers oder der universellen Sicherheitsgruppe Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Wenn Sie mehrere Benutzer oder universelle Sicherheitsgruppen hinzufügen möchten, trennen Sie diese durch Kommata.

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

-Members

Der Members-Parameter gibt die Postfächer oder E-Mail-aktivierten USGs an, die als Mitglied der Rollengruppe hinzugefügt werden sollen. Sie können den Benutzer oder die Gruppe anhand des Namens, DNs oder primären SMTP-Adresswerts identifizieren. Sie können mehrere Member angeben, die durch Kommas (Value1,Value2,...ValueN) getrennt sind. Wenn der Wert Leerzeichen enthält, schließen Sie den Wert in Anführungszeichen ("Value 1","Value 2",..."Value N") ein.

Wenn Sie den Members-Parameter verwenden, können Sie die Parameter LinkedForeignGroup, LinkedDomainController oder LinkedCredential nicht verwenden.

Type:MultiValuedProperty
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, Security & Compliance, Exchange Online Protection

-Name

Der Parameter Name gibt den Namen der neuen Rollengruppe an. Der Parameter darf maximal 64 Zeichen enthalten. Wenn der Name Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Hinweis: Wenn Sie eine verknüpfte Rollengruppe erstellen, empfiehlt es sich, den Namen der fremden Gesamtstruktur in den Namen der Rollengruppe aufzunehmen, damit Sie die verknüpfte Rollengruppe und die zugeordnete fremde Gesamtstruktur einfacher zuordnen können. Dies ist besonders wichtig, wenn Sie mehrere Gesamtstrukturen besitzen.

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

-RecipientOrganizationalUnitScope

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter RecipientOrganizationalUnitScope gibt den Bereich der Organisationseinheit an, der den erstellten Rollenzuweisungen hinzugefügt wurde als die Rollengruppe erstellt wurde. Bei Verwendung des Parameters RecipientOrganizationalUnitScope kann der Parameter CustomRecipientWriteScope nicht verwendet werden. Geben Sie mithilfe der folgenden Syntax eine Organisationseinheit an: Domäne/Organisationseinheit. Wenn der Organisationseinheitenname Leerzeichen enthält, setzen Sie die Domäne und die Organisationseinheit in Anführungszeichen (").

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

-Roles

Der Parameter Roles gibt die Verwaltungsrollen an, die der Rollengruppe, wenn sie erstellt wird, zugewiesen werden. Wenn ein Rollenname Leerzeichen enthält, setzen Sie ihn in Anführungszeichen ("). Wenn Sie mehrere Rollen zuweisen möchten, trennen Sie die Rollennamen durch Kommata.

Eine Liste der integrierten Verwaltungsrollen, die Sie einer Rollengruppe zuweisen können, finden Sie unter Integrierte Verwaltungsrollen.

Type:RoleIdParameter[]
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, Security & Compliance, Exchange Online Protection

-SamAccountName

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter SamAccountName (auch als Benutzerkonto oder Gruppenname vor Windows 2000 bezeichnet) gibt einen Objektbezeichner an, der mit älteren Versionen von Microsoft Windows-Client- und -Serverbetriebssystemen kompatibel ist. Der Wert kann Buchstaben, Zahlen, Leerzeichen, Punkte (.) und die folgenden Zeichen enthalten: !, #, $, %, ^, &-, _, {, }und ~. Das letzte Zeichen darf kein Punkt sein. Unicode-Zeichen sind zulässig, aber akzentierte Zeichen können Konflikte verursachen (z. B. o und ö übereinstimmen). Die maximale Länge beträgt 20 Zeichen.

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

-WellKnownObject

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill WellKnownObject Description }}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

Der WhatIf-Schalter funktioniert in PowerShell für Sicherheitskonformität & nicht.

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Aliases:wi
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, Security & Compliance, 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.