Set-SCUserRole
Ändert die Einstellungen für eine vorhandene VMM-Benutzerrolle.
Syntax
Set-SCUserRole
[-UserRole <UserRole>]
[-VMMServer <ServerConnection>]
[-Name <String>]
[-JobGroup <Guid>]
[-AddMember <String[]>]
[-RemoveMember <String[]>]
[-Permission <SelfServicePermission[]>]
[-UserRoleDataPath <String>]
[-RemoveLibraryStoreSharePath]
[-ShowPROTips <Boolean>]
[-AddScope <ClientObject[]>]
[-RemoveScope <ClientObject[]>]
[-Description <String>]
[-VMNetworkMaximum <UInt16>]
[-VMNetworkMaximumPerUser <UInt16>]
[-RemoveVMNetworkMaximum]
[-RemoveVMNetworkMaximumPerUser]
[-VPNConnectionMaximum <UInt16>]
[-VPNConnectionMaximumPerUser <UInt16>]
[-RemoveVPNConnectionMaximum]
[-RemoveVPNConnectionMaximumPerUser]
[-NATConnectionMaximum <UInt16>]
[-NATConnectionMaximumPerUser <UInt16>]
[-RemoveNATConnectionMaximum]
[-RemoveNATConnectionMaximumPerUser]
[-VMNetworkVPNMaximumBandwidthInKbps <UInt64>]
[-VMNetworkVPNMaximumBandwidthOutKbps <UInt64>]
[-RemoveVMNetworkVPNMaximumBandwidthIn]
[-RemoveVMNetworkVPNMaximumBandwidthOut]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Beschreibung
Das cmdlet Set-SCUserRole ändert die Einstellungen für eine vorhandene VMM-Benutzerrolle (Virtual Machine Manager). Die Einstellungen, die Sie ändern können, hängen vom Typ der VMM-Benutzerrolle ab.
Die Arten von Benutzerrollen sind wie folgt:
VMM-Administrator (Administrator)
Sie können Mitglieder zur Administratorbenutzerrolle hinzufügen oder daraus entfernen. Sie können den Bereich der Objekte, die Mitglieder dieser Rolle verwalten können, nicht einschränken.
Delegierter Administrator (Delegiertes Administrator)
Sie können Mitglieder zu einer Rolle eines delegierten Administrators hinzufügen und daraus entfernen. Sie können den Bereich einer Rolle eines delegierten Administrators erweitern oder einschränken. Sie können Mitgliedern dieser Benutzerrolle die Berechtigung erteilen, alle Objekte in privaten Clouds und Hostgruppen zu verwalten. Sie können Benutzern erlauben, alle objekte zu verwalten, die auf Bibliotheksservern gespeichert sind. Innerhalb dieses Frameworks können Sie die Aktionen, die Mitglieder der Benutzerrolle "Delegierter Administrator" ausführen können, nicht einschränken.
Read-Only-Administrator (ReadOnlyAdmin)
Sie können Mitglieder zu einer Read-Only Administratorbenutzerrolle hinzufügen und daraus entfernen. Sie können den Bereich einer Read-Only Administratorbenutzerrolle erweitern oder einschränken. Die Mitglieder der Benutzerrolle können jedoch nur die Eigenschaften, den Status und den Auftragsstatus der Objekte innerhalb ihres zugewiesenen Bereichs anzeigen. Sie können keines der Objekte ändern.
Self-Service Benutzer (SelfServiceUser)
Sie können Mitglieder zu einer Self-Service Benutzerrolle hinzufügen oder daraus entfernen. Sie können den Umfang und die Aktionen von Mitgliedern einer Self-Service Benutzerrolle erweitern oder einschränken. Sie können Mitgliedern einer Self-Service Benutzerrollenberechtigung erteilen, um alle Objekte in privaten Clouds zu verwalten. Sie können berechtigungen zum Erstellen virtueller Computer, zum Speichern virtueller Computer im gespeicherten Pfad des virtuellen Computers in der Cloud erteilen, auf dem sich der virtuelle Computer befindet, und die Berechtigung zum Verwenden von Vorlagenobjekten zum Erstellen virtueller Computer. Innerhalb dieses Frameworks können Sie Mitgliedern einer Self-Service Benutzerrollenaktionen gewähren, die Self-Service-Benutzer ausführen können. Sie können auch die Anzahl der virtuellen Computer einschränken, die Self-Service-Benutzer erstellen können, indem Sie ein Kontingent festlegen, das für jeden Benutzer oder für alle Benutzer zusammen gilt.
Die Aktionen, die Sie einem Self-Service-Benutzer gewähren können, umfassen Folgendes:
- AllowLocalAdmin. Gewährt lokalen Administratorrechten für Benutzer auf virtuellen Computern.
- Verfasser. Erstellen Sie virtuelle Computer- und Dienstvorlagen.
- CanShare. Freigeben von Ressourcen für andere Self-Service Benutzer.
- CanReceive. Empfangen von Ressourcen von anderen Self-Service Benutzern.
- Kontrollpunkt. Erstellen und Verwalten von Prüfpunkten für virtuelle Computer.
- CheckpointRestoreOnly. Ein Prüfpunkt kann nur wiederhergestellt werden.
- Schaffen. Erstellen Sie virtuelle Computer und Dienste nur aus Vorlagen.
- CreateFromVHDOrTemplate. Erstellen Sie virtuelle Computer und Dienste aus VHD-Dateien (Virtual Hard Disk, VHD) oder Vorlagen.
- PauseAndResume. Anhalten und Fortsetzen virtueller Computer und Dienste.
- RemoteConnect. Remoteverbindung mit virtuellen Computern herstellen.
- Entfernen. Entfernen Sie virtuelle Computer und Dienste.
- Retten. Speichern Sie virtuelle Computer und Dienste.
- Herunterfahren. Herunterfahren virtueller Computer.
- Anfangen. Starten Sie virtuelle Computer und Dienste.
- Aufhören. Beenden Sie virtuelle Computer und Dienste.
- Abspeichern. Speichern sie virtuelle Computer in einer Bibliothek.
Beispiele
Beispiel 1: Hinzufügen von Benutzern zur VMM-Administratorrolle
PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddMember "Contoso\User01","Contoso\User02"
Der erste Befehl ruft das Benutzerrollenobjekt mit dem Namen Administrator ab und speichert dieses Objekt dann in der variablen $UserRole.
Mit dem zweiten Befehl wird der Administratorbenutzerrolle "User01" und "User02" hinzugefügt. Beide Benutzer sind Mitglieder der Contoso.com Domäne.
Beispiel 2: Hinzufügen von Benutzern zur Administratorrolle mithilfe der Pipeline
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" | where { $_.Profile -eq "Administrator" } | Set-SCUserRole -AddMember "Contoso\User03"
Dieser Befehl ruft alle Benutzerrollenobjekte von VMMServer01 ab, wählt die Benutzerrollenobjekte aus, deren Profil Administrator ist, und fügt dann "User03" zur Administratorbenutzerrolle hinzu.
Beispiel 3: Ändern einer vorhandenen Self-Service Benutzerrolle durch Hinzufügen einer Cloud zum Bereich
PS C:\> $Cloud = Get-SCCloud -Name "Cloud02"
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddScope $Cloud
Der erste Befehl ruft das Cloudobjekt "Cloud02" ab und speichert dieses Objekt dann in der $Cloud Variablen.
Der zweite Befehl ruft das Benutzerrollenobjekt "ContosoSelfServiceUsers" ab und speichert das Objekt dann im $UserRole Profil.
Der letzte Befehl ändert den Bereich der in $UserRole gespeicherten Benutzerrolle, indem die in $Cloud gespeicherte Cloud zu ihrem Bereich hinzugefügt wird.
Beispiel 4: Entfernen des angegebenen Benutzers aus der Administratorbenutzerrolle
PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -RemoveMember "Contoso\User01"
Der erste Befehl ruft das Benutzerrollenobjekt mit dem Namen Administrator ab und speichert dieses Objekt dann in der variablen $UserRole.
Mit dem zweiten Befehl wird "User01" aus der Administratorbenutzerrolle entfernt. User01 ist Mitglied der Contoso.com Domäne.
Beispiel 5: Hinzufügen einer Cloud zum Bereich einer Self-Service Benutzerrolle
PS C:\> $Cloud = Get-SCCloud -Name "Cloud03"
PS C:\> Get-SCUserRole -Name "ContosoSelfServiceUsers" | Set-SCUserRole -AddScope $Cloud
Der erste Befehl ruft das Cloudobjekt "Cloud03" ab und speichert dieses Objekt dann in der $Cloud Variablen.
Der zweite Befehl ruft das Benutzerrollenobjekt namens ContosoSelfServiceUsers ab und übergibt dieses Benutzerrollenobjekt an das aktuelle Cmdlet. Mit diesem Cmdlet wird der Benutzerrolle die in $Cloud gespeicherte Cloud hinzugefügt.
Beispiel 6: Ändern der Aktionen, die Mitglieder einer Self-Service Benutzerrolle auf ihren virtuellen Computern ausführen können
PS C:\> $UserRole = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -Permission "Create,PauseAndResume,Stop,AllowLocalAdmin,Store"
Der erste Befehl ruft das Benutzerrollenobjekt auf VMMServer01 namens ContosoSelfServiceUsers ab und speichert das Objekt dann in der $UserRole Variablen.
Mit dem zweiten Befehl werden die Berechtigungen für Mitglieder der in $UserRole gespeicherten Benutzerrolle geändert, um die Berechtigungen "Creation", "PauseAndResume", "Stop", "AllowLocalAdmin" und "Store" zuzulassen.
Parameter
-AddMember
Gibt ein Array von Mitgliedern an, das dieses Cmdlet zu einem Objekt hinzufügt, das über das Konzept von Mitgliedern verfügt, z. B. eine Gruppe. Beispielsweise kann dieses Cmdlet einen oder mehrere Active Directory Domain® Services-Domänenbenutzer oder -Gruppen zu einer Benutzerrolle hinzufügen. Geben Sie Mitglieder in den folgenden Formaten an:
- Domäne\Benutzer
- Benutzer
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
Der Lab-Gruppenalias ist eine Active Directory Domain Services-Sicherheitsgruppe, nicht ein E-Mail-Alias.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AddScope
Gibt ein Array von Bereichen an, die dieses Cmdlet dem Bereich von Objekten hinzufügt, die Mitglieder dieser Benutzerrolle verwalten können.
Typ: | ClientObject[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die Benutzerrolle an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-JobVariable
Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt einen neuen Namen für die Benutzerrolle an.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NATConnectionMaximum
Typ: | UInt16 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NATConnectionMaximumPerUser
Typ: | UInt16 |
Position: | Named |
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 |
-Permission
Gibt ein Array von Aktionen an, die Mitglieder einer Self-Service Benutzerrolle auf ihren virtuellen Computern oder Diensten ausführen können. Gültige Werte sind:
- AllowLocalAdmin
- Verfasser
- CanShare
- CanReceive
- Kontrollpunkt
- CheckpointRestoreOnly
- Schaffen
- CreateFromVHDOrTemplate
- PauseAndResume
- RemoteVerbinden
- Entfernen
- Retten
- Herunterfahren
- Anfangen
- Aufhören
- Abspeichern
Wenn Sie die Berechtigung "CreateFromVHDOrTemplate" erteilen, erteilen Sie auch die Berechtigung "Erstellen". Wenn Sie die Prüfpunktberechtigung erteilen, erteilen Sie auch die Berechtigung "CheckpointRestoreOnly".
Typ: | SelfServicePermission[] |
Aliase: | VMPermission |
Zulässige Werte: | Create, PauseAndResume, Start, Stop, AllowLocalAdmin, RemoteConnect, Remove, Shutdown, Checkpoint, Store, Save, Author, CanShare, CanReceive, CreateFromVHDOrTemplate, CheckpointRestoreOnly, AuthorVMNetwork, CreateShielded |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PROTipID
Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
Typ: | Guid |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveLibraryStoreSharePath
Gibt an, dass dieses Cmdlet den Benutzerrollendatenpfad für einen Self-Service-Benutzer löscht.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveMember
Gibt ein Array von Mitgliedern an, das dieses Cmdlet aus einem VMM-Objekt entfernt, das das Konzept der Mitgliedschaft aufweist, z. B. eine Gruppe. Beispielsweise kann dieses Cmdlet einen oder mehrere Active Directory Domain Services-Domänenbenutzer oder -Gruppen aus einer Benutzerrolle entfernen. Geben Sie Mitglieder in den folgenden Formaten an:
- Domäne\Benutzer
- Benutzer
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
Der Lab-Gruppenalias ist eine Active Directory Domain Services-Sicherheitsgruppe, nicht ein E-Mail-Alias.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveNATConnectionMaximum
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveNATConnectionMaximumPerUser
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveScope
Gibt ein Array von VMM-Objekten an, die aus dem Bereich der Objekte entfernt werden sollen, die Mitglieder dieser Benutzerrolle verwalten können.
Typ: | ClientObject[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveVMNetworkMaximum
Gibt an, dass dieses Cmdlet die maximale Einstellung für das Netzwerk des virtuellen Computers entfernt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveVMNetworkMaximumPerUser
Gibt an, dass dieses Cmdlet das Netzwerk des virtuellen Computers pro Benutzereinstellung maximal entfernt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveVMNetworkVPNMaximumBandwidthIn
Gibt an, dass dieses Cmdlet die maximale Bandbreiteneinstellung für eingehende Verbindungen entfernt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveVMNetworkVPNMaximumBandwidthOut
Gibt an, dass dieses Cmdlet die Einstellung für die maximale VPN-Bandbreite für ausgehende Verbindungen entfernt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveVPNConnectionMaximum
Gibt an, dass dieses Cmdlet die maximale Einstellung für die VPN-Verbindung entfernt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RemoveVPNConnectionMaximumPerUser
Gibt an, dass dieses Cmdlet die MAXIMALE VPN-Verbindung pro Benutzereinstellung entfernt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ShowPROTips
Gibt an, ob PRO-Tipps angezeigt werden sollen. Dieser Parameter gilt nur für Self-Service Benutzerrollen.
Typ: | Boolean |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UserRole
Gibt ein Benutzerrollenobjekt an, das dieses Cmdlet ändert. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole.
Typ: | UserRole |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-UserRoleDataPath
Gibt den Pfad einer Bibliotheksfreigabe an, die Mitglieder einer Self-Service Benutzerrolle zum Hochladen von Daten verwenden können. Geben Sie den Pfad in diesem Format an: \LibraryServerName\LibraryShareName.
Typ: | String |
Aliase: | LibraryStoreSharePath |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VMMServer
Gibt den VMM-Server an, auf dem dieses Cmdlet eine Benutzerrolle ändert.
Typ: | ServerConnection |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VMNetworkMaximum
Gibt die maximale Anzahl virtueller Computernetzwerke für eine Benutzerrolle an.
Typ: | UInt16 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VMNetworkMaximumPerUser
Gibt die maximale Anzahl virtueller Computernetzwerke für einen Benutzer an.
Typ: | UInt16 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VMNetworkVPNMaximumBandwidthInKbps
Gibt die maximale Bandbreite, Kilobits pro Sekunde, für eingehenden Datenverkehr für ein VPN an.
Typ: | UInt64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VMNetworkVPNMaximumBandwidthOutKbps
Gibt die maximale Bandbreite, Kilobits pro Sekunde, für ausgehenden Datenverkehr für ein VPN an.
Typ: | UInt64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VPNConnectionMaximum
Gibt die maximale Anzahl von Verbindungen für ein VPN an.
Typ: | UInt16 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VPNConnectionMaximumPerUser
Gibt die maximale Anzahl von Verbindungen pro Benutzer für ein VPN an.
Typ: | UInt16 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Ausgaben
UserRole
Hinweise
- Wenn Sie alle verfügbaren Berechtigungen auflisten möchten, die Sie für Self-Service-Benutzer angeben können, geben Sie den folgenden Befehl ein:
PS C:\> [enum]::GetValues([Microsoft.VirtualManager.Remoting.SelfServicePermission])