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, virtuell datoradministratör 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 användarrollen Delegerad administratör 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 cmdleten Set-SCUserRole för att byta namn på användarrollen, lägga till eller ta bort medlemmar och lägga till eller ändra omfattningen 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 den rollen.
Information om hur du ändrar egenskaperna för en användarroll Get-Help Set-SCUserRolefinns i .
Exempel
Exempel 1: Skapa en delegerad administratörsanvändarroll
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än 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 virtuell datoradministratörsanvändarroll med namnet VirtualMachineAdmin, ger beskrivningen "Virtuell datoradministratör för contoso.com domän" och använder parametern UserRoleProfile för att ange användarrolltypen som VMAdmin.
Parametrar
-Description
Anger en beskrivning av användarrollen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Anger det unika ID:t för den nya användarrollen.
| Type: | Guid |
| 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 slutliga 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 jobbstatus spåras och lagras.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Anger ett namn för den nya användarrollen.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 hämta 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 |
-ParentUserRole
Anger en befintlig VMM-användarroll som överordnad för den nya användarrollen.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Guid |
| 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 |
-UserRoleProfile
Anger vilken typ av profil som utgör grunden för den nya användarrollen. De acceptabla värdena för den här parametern är:
- DelegatedAdmin
- ReadOnlyAdmin
- SelfServiceUser
- TenantAdmin
- 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
Anger den VMM-server där den här cmdleten skapar en användarroll.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Utdata
UserRole
Den här cmdleten returnerar ett UserRole-objekt .