New-SCUserRole
Erstellt eine Benutzerrolle für eine Gruppe von VMM-Benutzern.
Syntax
New-SCUserRole
[-VMMServer <ServerConnection>]
[-Name] <String>
-UserRoleProfile <Profile>
[-ID <Guid>]
[-JobGroup <Guid>]
[-Description <String>]
[-ParentUserRole <UserRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Beschreibung
Das Cmdlet New-SCUserRole erstellt eine Benutzerrolle für eine Gruppe von VMM-Benutzern (Virtual Machine Manager). Sie können die folgenden Benutzerrollen erstellen: Delegierter Administrator, Read-Only Administrator, Virtueller Computeradministrator und Self-Service Benutzer. Es ist nur eine Administratorrolle vorhanden. Sie können keine andere Administratorrolle erstellen oder die vorhandene löschen.
Wenn Sie Mitglied einer Delegierten Administratorrolle sind, können Sie eine Benutzerrolle erstellen. Der Umfang der neuen Benutzerrolle muss jedoch eine Teilmenge des Bereichs seiner übergeordneten Benutzerrolle sein.
Nachdem Sie eine Benutzerrolle erstellt haben, können Sie das Cmdlet Set-SCUserRole verwenden, um die Benutzerrolle umzubenennen, Mitglieder hinzuzufügen oder zu entfernen und den Bereich der Objekte hinzuzufügen oder zu ändern, die Mitglieder der Rolle verwalten können. Für eine Self-Service Benutzerrolle können Sie angeben, welche Aktionen Mitglieder einer Self-Service Benutzerrolle auf ihren virtuellen Computern ausführen können, und Sie können ein Kontingent definieren, das die Anzahl der self-Service-Benutzer einschränken kann. Obwohl Sie die Administratorrolle nicht erstellen oder entfernen oder den Bereich einschränken können, können Sie Set-SCUserRole verwenden, um Mitglieder zu dieser Rolle hinzuzufügen oder zu entfernen.
Informationen dazu, wie Sie die Eigenschaften einer Benutzerrolle ändern, geben Sie diesen Typ Get-Help Set-SCUserRoleein.
Beispiele
Beispiel 1: Erstellen einer Delegierten Administratorrolle
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Dieser Befehl erstellt eine delegierte Administratorrolle namens ContosoDelegatedAdmin, stellt die Beschreibung Delegierte Administratoren für die domäne Contoso.com bereit, und verwendet den UserRoleProfile-Parameter , um den Benutzerrollentyp als delegierter Administrator festzulegen.
Beispiel 2: Erstellen einer Self Service-Benutzerrolle
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Dieser Befehl erstellt eine neue Benutzerrolle namens ContosoSelfServiceUsers, verwendet den UserRoleProfile-Parameter , um den neuen Benutzerrollentyp als Self-Service Benutzer festzulegen und das neue Benutzerrolleobjekt in der $SelfServiceRole Variable zu speichern.
Beispiel 3: Erstellen einer Rolle für einen virtuellen Computeradministrator
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Dieser Befehl erstellt eine Benutzerrolle des virtuellen Computers namens VirtualMachineAdmin, stellt die Beschreibung "Virtual Machine Administrator für contoso.com Domäne" bereit und verwendet den UserRoleProfile-Parameter, um den Benutzerrollentyp als VMAdmin festzulegen.
Parameter
-Description
Gibt eine Beschreibung für die Benutzerrolle an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Gibt die eindeutige ID für die neue Benutzerrolle an.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem letzten Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt einen Namen für die neue Benutzerrolle an.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
-ParentUserRole
Gibt eine vorhandene VMM-Benutzerrolle als übergeordnetes Element der neuen Benutzerrolle an.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
| Type: | SwitchParameter |
| 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 neue Benutzerrolle ist. Zulässige Werte für diesen Parameter:
- DelegierterAdmin
- ReadOnlyAdmin
- SelfServiceUser
- MandantAdmin
- VMAdmin
| Type: | Profile |
| Accepted values: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Gibt den VMM-Server an, auf dem dieses Cmdlet eine Benutzerrolle erstellt.
| 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.