New-SCUserRole
Skapar en användarroll för en grupp VMM-användare.
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>] Description
Cmdleten New-SCUserRole skapar en användarroll för en grupp VMM-användare (Virtual Machine Manager). Du kan skapa följande användarroller: Delegerad administratör, Read-Only administratör, administratör för virtuell dator och Self-Service användare. Det finns bara en administratörsroll. Du kan inte skapa en annan administratörsroll eller ta bort den befintliga.
Om du är medlem i en delegerad administratörsanvändarroll kan du skapa en användarroll. Omfånget för den nya användarrollen måste dock vara en delmängd av omfånget för dess överordnade användarroll.
När du har skapat en användarroll kan du använda Set-SCUserRole cmdlet för att byta namn på användarrollen, lägga till eller ta bort medlemmar och för att lägga till eller ändra omfånget för objekt som medlemmar i rollen kan hantera. För en Self-Service användarroll kan du ange vilka åtgärder medlemmar i en Self-Service användarroll kan vidta på sina virtuella datorer, och du kan definiera en kvot som begränsar antalet virtuella datorer som självbetjäningsanvändare kan skapa. Även om du inte kan skapa eller ta bort administratörsrollen eller begränsa dess omfång kan du använda Set-SCUserRole- för att lägga till eller ta bort medlemmar i rollen.
Om du vill ha information om hur du ändrar egenskaperna för en användarroll skriver du Get-Help Set-SCUserRole.
Exempel
Exempel 1: Skapa en användarroll för delegerad administratör
PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"Det här kommandot skapar en delegerad administratörsanvändarroll med namnet ContosoDelegatedAdmin, ger beskrivningen Delegerade administratörer för Contoso.com-domänen och använder parametern UserRoleProfile för att ange användarrolltypen som Delegerad administratör.
Exempel 2: Skapa en självbetjäningsanvändarroll
PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"Det här kommandot skapar en ny användarroll med namnet ContosoSelfServiceUsers, använder parametern UserRoleProfile för att ange den nya användarrolltypen som Self-Service användare och lagrar det nya användarrollobjektet i variabeln $SelfServiceRole.
Exempel 3: Skapa en administratörsroll för virtuell dator
PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"Det här kommandot skapar en användarroll för virtuell dator med namnet VirtualMachineAdmin, ger beskrivningen "Virtual Machine Administrator for contoso.com domain" och använder parametern UserRoleProfile för att ange användarrolltypen vmAdmin.
Parametrar
-Description
Anger en beskrivning av användarrollen.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ID
Anger det unika ID:t för den nya användarrollen.
| Typ: | Guid |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-JobGroup
Anger en identifierare för en serie kommandon som körs som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.
| Typ: | Guid |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-JobVariable
Anger en variabel där jobbstatus spåras och lagras.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-Name
Anger ett namn för den nya användarrollen.
| Typ: | String |
| Position: | 0 |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-OnBehalfOfUser
Anger ett användarnamn. Den här cmdleten fungerar för användaren som den här parametern anger.
| Typ: | String |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | 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.
| Typ: | UserRole |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-ParentUserRole
Anger en befintlig VMM-användarroll som överordnad för den nya användarrollen.
| Typ: | UserRole |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-PROTipID
Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.
| Typ: | Guid |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-RunAsynchronously
Anger att jobbet körs asynkront så att kontrollen omedelbart återgår till kommandogränssnittet.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-UserRoleProfile
Anger vilken typ av profil som ligger till grund för den nya användarrollen. De godtagbara värdena för den här parametern är:
- DelegeradAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- VMAdmin
| Typ: | Profile |
| Godkända värden: | Administrator, DelegatedAdmin, VMAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | True |
| Godkänn pipeline-indata: | False |
| Godkänn jokertecken: | False |
-VMMServer
Anger den VMM-server där den här cmdleten skapar en användarroll.
| Typ: | ServerConnection |
| Position: | Named |
| Standardvärde: | None |
| Obligatorisk: | False |
| Godkänn pipeline-indata: | True |
| Godkänn jokertecken: | False |
Utdata
UserRole
Den här cmdleten returnerar ett UserRole- objekt.