Delen via

New-SCUserRole

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een gebruikersrol voor een groep VMM-gebruikers.

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

Met de cmdlet New-SCUserRole maakt u een gebruikersrol voor een groep VMM-gebruikers (Virtual Machine Manager). U kunt de volgende gebruikersrollen maken: Gedelegeerde beheerder, Read-Only administrator, beheerder van virtuele machines en Self-Service gebruiker. Er bestaat slechts één beheerdersrol. U kunt geen andere beheerdersrol maken of de bestaande rol verwijderen.

Als u lid bent van een gebruikersrol Gedelegeerde beheerder, kunt u een gebruikersrol maken. Het bereik van de nieuwe gebruikersrol moet echter een subset zijn van het bereik van de bovenliggende gebruikersrol.

Nadat u een gebruikersrol hebt gemaakt, kunt u de cmdlet Set-SCUserRole gebruiken om de naam van de gebruikersrol te wijzigen, leden toe te voegen of te verwijderen en het bereik van objecten toe te voegen of te wijzigen die leden van de rol kunnen beheren. Voor een Self-Service gebruikersrol kunt u opgeven welke acties leden van een Self-Service gebruikersrol kunnen uitvoeren op hun virtuele machines en u kunt een quotum definiëren waarmee het aantal selfservicegebruikers van virtuele machines wordt beperkt. Hoewel u de beheerdersrol niet kunt maken of verwijderen of het bereik ervan kunt beperken, kunt u Set-SCUserRole gebruiken om leden aan die rol toe te voegen of te verwijderen.

Typ voor informatie over het wijzigen van de eigenschappen van een gebruikersrol Get-Help Set-SCUserRole.

Voorbeelden

Voorbeeld 1: Een gebruikersrol Gedelegeerde beheerder maken

PS C:\> New-SCUserRole -Name "ContosoDelegatedAdmin" -Description "Delegated Administrators for the Contoso.com domain" -UserRoleProfile "DelegatedAdmin"

Met deze opdracht maakt u een gedelegeerde beheerdersrol met de naam ContosoDelegatedAdmin, geeft u de beschrijving Gedelegeerde beheerders voor het Contoso.com domein en gebruikt u de parameter UserRoleProfile om het gebruikersroltype aan te wijzen als gedelegeerde beheerder.

Voorbeeld 2: Een selfservicegebruikersrol maken

PS C:\> $SelfServiceRole = New-SCUserRole -Name "ContosoSelfServiceUsers" -UserRoleProfile "SelfServiceUser"

Met deze opdracht maakt u een nieuwe gebruikersrol met de naam ContosoSelfServiceUsers, gebruikt u de parameter UserRoleProfile om het nieuwe gebruikersroltype aan te wijzen als Self-Service gebruiker en slaat u het nieuwe gebruikersrolobject op in de $SelfServiceRole variabele.

Voorbeeld 3: Een rol virtuele-machinebeheerder maken

PS C:\> New-SCUserRole -Name "VirtualMachineAdmin" -UserRoleProfile "VMAdmin" -Description "Virtual Machine administrator for contoso.com domain"

Met deze opdracht maakt u de gebruikersrol Virtual Machine Administrator met de naam VirtualMachineAdmin, geeft u de beschrijving 'Virtual Machine administrator for contoso.com domain' en gebruikt u de parameter UserRoleProfile om het gebruikersroltype aan te wijzen als VMAdmin.

Parameters

-Description

Hiermee geeft u een beschrijving voor de gebruikersrol.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ID

Hiermee geeft u de unieke id voor de nieuwe gebruikersrol.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Hiermee geeft u een variabele op waarin de voortgang van de taak wordt bijgehouden en opgeslagen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u een naam op voor de nieuwe gebruikersrol.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam op. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die door deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ParentUserRole

Hiermee geeft u een bestaande VMM-gebruikersrol op als het bovenliggende element van de nieuwe gebruikersrol.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u pro-tips controleren.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleProfile

Hiermee geeft u het type profiel op dat de basis is voor de nieuwe gebruikersrol. De aanvaardbare waarden voor deze parameter zijn:

  • 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

Hiermee geeft u de VMM-server waarop deze cmdlet een gebruikersrol maakt.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Uitvoerwaarden

UserRole

Met deze cmdlet wordt een UserRole-object geretourneerd.