Set-SCUserRole
Ändrar inställningarna för en befintlig VMM-användarroll.
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>] Description
Cmdleten Set-SCUserRole ändrar inställningarna för en befintlig användarroll för Virtual Machine Manager (VMM). Vilka inställningar du kan ändra beror på typen av VMM-användarroll.
Typerna av användarroller är följande:
VMM-administratör (administratör)
Du kan lägga till medlemmar i eller ta bort medlemmar från användarrollen Administratör. Du kan inte begränsa omfånget för objekt som medlemmar i den här rollen kan hantera.
Delegerad administratör (DelegatedAdmin)
Du kan lägga till medlemmar i och ta bort medlemmar från en delegerad administratörsanvändarroll. Du kan expandera eller begränsa omfånget för en delegerad administratörsanvändarroll. Du kan ge medlemmar i den här användarrollen behörighet att hantera alla objekt i privata moln och värdgrupper. Du kan tillåta användare att hantera alla objekt som lagras på biblioteksservrar. Inom det ramverket kan du inte begränsa vilka åtgärder som medlemmar i användarrollen Delegerad administratör kan utföra.
Read-Only administratör (ReadOnlyAdmin)
Du kan lägga till medlemmar i och ta bort medlemmar från användarrollen Read-Only administratör. Du kan expandera eller begränsa omfånget för användarrollen Read-Only administratör. Medlemmarna i användarrollen kan dock bara visa egenskaperna, statusen och jobbstatusen för objekten inom det tilldelade omfånget. De kan inte ändra något av objekten.
Self-Service användare (SelfServiceUser)
Du kan lägga till medlemmar i eller ta bort medlemmar från en Self-Service användarroll. Du kan expandera eller begränsa omfånget och åtgärderna för medlemmar i en Self-Service användarroll. Du kan ge medlemmar i en Self-Service användarroll behörighet att hantera alla objekt i privata moln. Du kan bevilja behörighet att skapa virtuella datorer, behörighet att lagra virtuella datorer i sökvägen till den lagrade virtuella datorn i molnet som den virtuella datorn är på och behörighet att använda mallobjekt för att skapa virtuella datorer. Inom det ramverket kan du bevilja medlemmar i en Self-Service användarrollsåtgärder som självbetjäningsanvändare kan vidta. Du kan också begränsa antalet virtuella datorer som självbetjäningsanvändare kan skapa genom att ange en kvot som gäller för varje användare eller för alla användare gemensamt.
De åtgärder som du kan bevilja en självbetjäningsanvändare omfattar följande:
- AllowLocalAdmin. Ger användaren lokal administratörsbehörighet på virtuella datorer.
- Författare. Skapa mallar för virtuella datorer och tjänster.
- CanShare. Dela resurser med andra Self-Service användare.
- CanReceive. Ta emot resurser från andra Self-Service användare.
- Checkpoint. Skapa och hantera kontrollpunkter för virtuella datorer.
- CheckpointRestoreOnly. Det går bara att återställa en kontrollpunkt.
- Skapa. Skapa endast virtuella datorer och tjänster från mallar.
- CreateFromVHDOrTemplate. Skapa virtuella datorer och tjänster från VHD-filer (virtuell hårddisk) eller mallar.
- PauseAndResume. Pausa och återuppta virtuella datorer och tjänster.
- RemoteConnect. Fjärranslut till virtuella datorer.
- Ta bort. Ta bort virtuella datorer och tjänster.
- Spara. Spara virtuella datorer och tjänster.
- Avstängning. Stäng av virtuella datorer.
- Start. Starta virtuella datorer och tjänster.
- Stanna. Stoppa virtuella datorer och tjänster.
- Lagra. Lagra virtuella datorer i ett bibliotek.
Exempel
Exempel 1: Lägga till användare i användarrollen VMM-administratör
PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddMember "Contoso\User01","Contoso\User02"Det första kommandot hämtar användarrollobjektet med namnet Administratör och lagrar sedan objektet i variabeln $UserRole.
Det andra kommandot lägger till User01 och User02 i användarrollen Administratör. Båda användarna är medlemmar i Contoso.com domänen.
Exempel 2: Lägg till användare i administratörsrollen med hjälp av pipelinen
PS C:\> Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" | where { $_.Profile -eq "Administrator" } | Set-SCUserRole -AddMember "Contoso\User03"Det här kommandot hämtar alla användarrollobjekt från VMMServer01, markerar de användarrollobjekt vars profil är Administratör och lägger sedan till User03 i användarrollen Administratör.
Exempel 3: Ändra en befintlig Self-Service användarroll genom att lägga till ett moln i dess omfång
PS C:\> $Cloud = Get-SCCloud -Name "Cloud02"
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -AddScope $CloudDet första kommandot hämtar molnobjektet med namnet Cloud02 och lagrar sedan objektet i variabeln $Cloud.
Det andra kommandot hämtar användarrollobjektet med namnet ContosoSelfServiceUsers och lagrar sedan objektet i $UserRole profilen.
Det sista kommandot ändrar omfånget för användarrollen som lagras i $UserRole genom att lägga till molnet som lagras i $Cloud i dess omfång.
Exempel 4: Ta bort den angivna användaren från användarrollen Administratör
PS C:\> $UserRole = Get-SCUserRole -Name "Administrator"
PS C:\> Set-SCUserRole -UserRole $UserRole -RemoveMember "Contoso\User01"Det första kommandot hämtar användarrollobjektet med namnet Administratör och lagrar sedan objektet i variabeln $UserRole.
Det andra kommandot tar bort User01 från användarrollen Administratör. User01 är medlem i Contoso.com domänen.
Exempel 5: Lägga till ett moln i omfånget för en Self-Service användarroll
PS C:\> $Cloud = Get-SCCloud -Name "Cloud03"
PS C:\> Get-SCUserRole -Name "ContosoSelfServiceUsers" | Set-SCUserRole -AddScope $CloudDet första kommandot hämtar molnobjektet med namnet Cloud03 och lagrar sedan objektet i variabeln $Cloud.
Det andra kommandot hämtar användarrollobjektet med namnet ContosoSelfServiceUsers och skickar sedan användarrollsobjektet till den aktuella cmdleten. Den här cmdleten lägger till molnet som lagras i $Cloud till användarrollen.
Exempel 6: Ändra vilka åtgärder medlemmar i en Self-Service användarroll kan vidta på sina virtuella datorer
PS C:\> $UserRole = Get-SCUserRole -VMMServer "VMMServer01.Contoso.com" -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCUserRole -UserRole $UserRole -Permission "Create,PauseAndResume,Stop,AllowLocalAdmin,Store"Det första kommandot hämtar användarrollsobjektet på VMMServer01 med namnet ContosoSelfServiceUsers och lagrar sedan objektet i variabeln $UserRole.
Det andra kommandot ändrar behörigheterna för medlemmar i användarrollen som lagras i $UserRole för att tillåta behörigheterna Skapa, PausaAndResume, Stoppa, AllowLocalAdmin och Store.
Parametrar
-AddMember
Anger en matris med medlemmar som denna cmdlet lägger till i ett objekt som har begreppet medlemmar, till exempel en grupp. Den här cmdleten kan till exempel lägga till en eller flera Active Directory Domain Services-domänanvändare® eller -grupper i en användarroll. Ange medlemmar i följande format:
- Domän\användare
- Användare
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
Labbgruppens alias är en Active Directory Domain Services säkerhetsgrupp, inte ett e-postalias.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddScope
Anger en matris med omfång som den här cmdleten lägger till i omfånget för objekt som medlemmar i den här användarrollen kan hantera.
| Type: | ClientObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Anger en beskrivning av användarrollen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Anger en identifierare för en serie kommandon som körs som en uppsättning precis innan det sista kommandot som innehåller samma jobbgruppsidentifierare körs.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Anger en variabel där jobb förloppet spåras och lagras.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Anger ett nytt namn för användarrollen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NATConnectionMaximum
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NATConnectionMaximumPerUser
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Anger ett användarnamn. Den här cmdleten fungerar för användarens räkning som den här parametern anger.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Anger en användarroll. Om du vill skaffa en användarroll använder du cmdleten Get-SCUserRole . Den här cmdleten fungerar för den användarroll som den här parametern anger.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Permission
Anger en matris med åtgärder som medlemmar i en Self-Service användarroll kan utföra på sina virtuella datorer eller tjänster. Giltiga värden är:
- AllowLocalAdmin
- Författare
- CanShare
- CanReceive
- Checkpoint
- CheckpointRestoreOnly
- Skapa
- CreateFromVHDOrTemplate
- PauseAndResume
- RemoteConnect
- Ta bort
- Spara
- Avstängning
- Start
- Stoppa
- Lagringsplats
Om du beviljar behörigheten CreateFromVHDOrTemplate beviljar du även behörigheten Skapa. Om du beviljar kontrollpunktsbehörigheten beviljar du även CheckpointRestoreOnly-behörighet.
| Type: | SelfServicePermission[] |
| Aliases: | VMPermission |
| Accepted values: | Create, PauseAndResume, Start, Stop, AllowLocalAdmin, RemoteConnect, Remove, Shutdown, Checkpoint, Store, Save, Author, CanShare, CanReceive, CreateFromVHDOrTemplate, CheckpointRestoreOnly, AuthorVMNetwork, CreateShielded |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveLibraryStoreSharePath
Anger att denna cmdlet rensar datasökvägen för användarrollen för en självbetjäningsanvändare.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveMember
Anger en matris med medlemmar som denna cmdlet tar bort från ett VMM-objekt som har begreppet medlemskap, till exempel en grupp. Den här cmdleten kan till exempel ta bort en eller flera Active Directory Domain Services domänanvändare eller grupper från en användarroll. Ange medlemmar i följande format:
- Domän\användare
- Användare
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
Labbgruppens alias är en Active Directory Domain Services säkerhetsgrupp, inte ett e-postalias.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveNATConnectionMaximum
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveNATConnectionMaximumPerUser
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveScope
Anger en matris med VMM-objekt som ska raderas från omfånget för objekt som medlemmar i den här användarrollen kan hantera.
| Type: | ClientObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveVMNetworkMaximum
Anger att den här cmdleten tar bort den virtuella datorns nätverks maximuminställning.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveVMNetworkMaximumPerUser
Anger att den här cmdleten tar bort den virtuella datorns nätverksmaxvärde per användare.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveVMNetworkVPNMaximumBandwidthIn
Anger att den här cmdleten tar bort inställningen för maximal bandbredd för virtuella privata nätverk (VPN) för inkommande anslutningar.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveVMNetworkVPNMaximumBandwidthOut
Anger att den här cmdleten tar bort vpn-inställningen för maximal bandbredd för utgående anslutningar.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveVPNConnectionMaximum
Anger att den här cmdleten tar bort maxinställningen för VPN-anslutning.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveVPNConnectionMaximumPerUser
Anger att den här cmdleten tar bort vpn-anslutningens maxvärde per användare.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ShowPROTips
Anger om PRO-tips ska visas. Den här parametern gäller endast för Self-Service användarroller.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
Anger ett användarrollobjekt som den här cmdleten ändrar. Om du vill skaffa en användarroll använder du cmdleten Get-SCUserRole .
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UserRoleDataPath
Anger sökvägen till en biblioteksresurs som medlemmar i en Self-Service användarroll kan använda för att ladda upp data. Ange sökvägen i det här formatet: \LibraryServerName\LibraryShareName.
| Type: | String |
| Aliases: | LibraryStoreSharePath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Anger den VMM-server där denna cmdlet ändrar en användarroll.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMNetworkMaximum
Anger det maximala antalet virtuella datornätverk för en användarroll.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMNetworkMaximumPerUser
Anger det maximala antalet virtuella datornätverk för en användare.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMNetworkVPNMaximumBandwidthInKbps
Anger den maximala bandbredden, kilobit per sekund, för inkommande trafik för ett VPN.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMNetworkVPNMaximumBandwidthOutKbps
Anger den maximala bandbredden, kilobit per sekund, för utgående trafik för ett VPN.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VPNConnectionMaximum
Anger det maximala antalet anslutningar för ett VPN.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VPNConnectionMaximumPerUser
Anger det maximala antalet anslutningar per användare för ett VPN.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Utdata
UserRole
Kommentarer
- Om du vill visa en lista över alla tillgängliga behörigheter som du kan ange för självbetjäningsanvändare skriver du följande kommando:
PS C:\> [enum]::GetValues([Microsoft.VirtualManager.Remoting.SelfServicePermission])