Freigeben über

Get-SCUserRole

  • Referenz
Modul:
VirtualMachineManager

Ruft eine VMM-Benutzerrolle ab.

Syntax

Get-SCUserRole
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-UserRoleProfile <Profile>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-SCUserRole ruft eine oder mehrere VMM-Benutzerrollen (Virtual Machine Manager) ab. VMM verwendet rollenbasierte Sicherheit, um die Grenzen zu definieren, in denen Mitglieder einer bestimmten Benutzerrolle ausgeführt werden können, und die Gruppe zulässiger Vorgänge, die Mitglieder einer Benutzerrolle ausführen können.

Geben Sie Get-Help New-SCUserRoleein, um Informationen zum Erstellen von Benutzerrollen zu erstellen.

Informationen zum Festlegen der Eigenschaften einer Benutzerrolle, einschließlich des Bereichs für delegierte und schreibgeschützte Administratoren und des Bereichs und der Aktionen für Self-Service-Benutzer, geben Sie Get-Help Set-SCUserRoleein.

Beispiele

Beispiel 1: Abrufen aller Benutzerrollen

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"

Dieser Befehl ruft alle VMM-Benutzerrollen auf dem Server mit dem Namen VMMServer01.Contoso.com ab. Der Befehl zeigt Informationen zu jeder Benutzerrolle an.

Beispiel 2: Abrufen einer Benutzerrolle anhand des Namens

PS C:\> Get-SCUserRole -Name "Administrator"

Dieser Befehl ruft das Benutzerrollenobjekt namens Administrator ab. Der Befehl zeigt Informationen zu dieser Benutzerrolle an.

Beispiel 3: Abrufen einer Benutzerrolle nach Profil

PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -UserRoleProfile "SelfServiceUser"

Dieser Befehl ruft die Benutzerrollen des Servers mit dem Namen VMMServer01 ab, der über ein Benutzerrollenprofil von SelfServiceUser verfügt. Der Befehl zeigt Informationen zu diesen Benutzerrollen an.

Beispiel 4: Anzeigen von Eigenschaften und anderen Informationen zu Benutzerrollenobjekten

PS C:\> $UserRoles = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com"
PS C:\> $UserRoles | Select-Object -Property Name, UserRoleProfile, ParentUserRole, Cloud
PS C:\> $UserRoles | Get-Member

Der erste Befehl ruft alle Benutzerrollenobjekte auf dem Server mit dem Namen VMMServer01 ab und speichert diese Objekte dann in der $UserRoles Variablen.

Der zweite Befehl übergibt jedes Benutzerrollenobjekt in $UserRoles an das Cmdlet Select-Object, das dann den Namen, das Benutzerrollenprofil, die übergeordnete Benutzerrolle und die Cloud für jede Benutzerrolle anzeigt.

Der letzte Befehl übergibt jede Benutzerrolle in $UserRoles an das Cmdlet Get-Member, das den .NET-Typ für jede Benutzerrolle sowie die Methoden und Eigenschaften anzeigt, die den einzelnen Benutzerrollentypen zugeordnet sind.

Parameter

-ID

Gibt die eindeutige ID für die Benutzerrolle an, die dieses Cmdlet abruft.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der VMM-Benutzerrolle an, die dieses Cmdlet abruft.

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRoleProfile

Gibt den Typ des Profils an, das die Basis für die Benutzerrollen ist, die dieses Cmdlet abruft. Die zulässigen Werte für diesen Parameter sind:

  • DelegiertesAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Typ:Profile
Zulässige Werte:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt den VMM-Server an, auf dem dieses Cmdlet Benutzerrollen abruft.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

UserRole

Dieses Cmdlet gibt ein UserRole-Objekt zurück.