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 Virtual Machine Manager (VMM)-Benutzerrollen 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-SCUserRoleInformationen zum Erstellen von Benutzerrollen ein.

Informationen zum Festlegen der Eigenschaften einer Benutzerrolle, einschließlich des Umfangs delegierter und schreibgeschützter Administratoren und der Bereiche und Aktionen für Self-Service-Benutzer, geben Sie den Typ Get-Help Set-SCUserRole".

Beispiele

Beispiel 1: Abrufen aller Benutzerrollen

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

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

Beispiel 2: Abrufen einer Benutzerrolle nach Name

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

Dieser Befehl ruft das Benutzerrolleobjekt 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 vom Server mit dem Namen VMMServer01 ab, die über ein Benutzerrollenprofil von SelfServiceUser verfügen. 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 und die Methoden und Eigenschaften anzeigt, die jedem Benutzerrollentyp zugeordnet sind.

Parameter

-ID

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

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

-Name

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

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

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-UserRoleProfile

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

  • DelegierterAdmin
  • ReadOnlyAdmin
  • SelfServiceUser
Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

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

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

Ausgaben

UserRole

Dieses Cmdlet gibt ein UserRole-Objekt zurück.