Freigeben über


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])