Get-MsolRoleMember

  • Referenz
Modul:
MSOnline

Ruft Mitglieder einer Rolle ab.

Syntax

Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolRoleMember
   [-RoleObjectId <Guid>]
   [-MemberObjectTypes <String[]>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-MsolRoleMember ruft Mitglieder der angegebenen Rolle ab.

Beispiele

Beispiel 1: Abrufen von Mitgliedern einer Rolle

PS C:\> $Role = Get-MsolRole -RoleName "%Role Name%"
PS C:\> $RoleMembers = Get-MsolRoleMember -RoleObjectId $Role.ObjectId

Dieser Befehl gibt alle Member der angegebenen Rolle zurück. Der Befehl speichert die Ergebnisse in der variablen $RoleMembers.

Parameter

-All

Gibt an, dass dieses Cmdlet alle Ergebnisse zurückgibt, die gefunden werden. Geben Sie diesen Parameter und den MaxResults-Parameter nicht an.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MaxResults

Gibt die maximale Anzahl von Ergebnissen an, die dieses Cmdlet zurückgibt. Der Standardwert ist 250.

Type:Int32
Position:Named
Default value:250
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemberObjectTypes

Gibt ein Array von Memberobjekttypen an.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleObjectId

Gibt die eindeutige ID der Rolle an, aus der Mitglieder entfernt werden sollen.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SearchString

Gibt eine Zeichenfolge an. Dieses Cmdlet gibt Objekte mit einem Anzeigenamen oder einer E-Mail-Adresse zurück, die mit dieser Zeichenfolge beginnen. Die zu durchsuchende Zeichenfolge.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Gibt die eindeutige ID des Mandanten an, auf dem der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Ausgaben

Microsoft.Online.Administation.RoleMember

Dieses Cmdlet gibt Rollenelementobjekte zurück, die die folgenden Informationen enthalten:

  • Displayname. Der Anzeigename des Rollenmitglieds.

  • Emailaddress. Die E-Mail-Adresse des Rollenmitglieds.

  • IsLicensed. Gibt an, ob der Benutzer lizenziert ist.

  • LastDirSyncTime. Das Datum und die Uhrzeit der letzten Synchronisierung dieses Mitglieds.

  • Objectid. Die eindeutige ID des Mitglieds.

  • OverallProvisioningStatus. Der Bereitstellungsstatus dieses Benutzers.

  • RoleMemberType. Der Typ des Rollenelements. Zurzeit wird nur User unterstützt.

  • Ein ValidationStatus. Gibt an, ob für dieses Gruppenmitglied Fehler aufgetreten sind.