Get-SCUserRole
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.
Informationen zum Erstellen von Benutzerrollen geben Sie Get-Help New-SCUserRole
.
Informationen zum Festlegen der Eigenschaften einer Benutzerrolle, einschließlich des Bereichs delegierter und schreibgeschützter Administratoren sowie des Bereichs und der Aktionen für Self-Service-Benutzer, geben Sie den Get-Help Set-SCUserRole
Typ ein.
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 nach Name
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 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 Namen 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. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen 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, der 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.