Delen via

Grant-SCResource

  • Referentie
Module:
VirtualMachineManager

Verleent een gebruiker of selfservicegebruikersrol toegang tot een resource.

Syntax

Grant-SCResource
     [-VMMServer <ServerConnection>]
     -Resource <ClientObject>
     [-UserRoleName <String[]>]
     [-UserRoleID <Guid[]>]
     [-UserName <String>]
     [-JobGroup <Guid>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-OnBehalfOfUser <String>]
     [-OnBehalfOfUserRole <UserRole>]
     [<CommonParameters>]

Description

De Cmdlet Grant-SCResource verleent een gebruiker of selfservicegebruikersrol toegang tot een resource.

Typen resources die u kunt delen met Grant-SCResource zijn onder andere:

  • Servicesjablonen

  • Virtuele-machinesjablonen

  • Profielen van gastbesturingssystemen

  • SQL Server-profielen

  • Hardwareprofielen

  • Toepassingsprofielen

  • Services

  • Virtuele machines

Voorbeelden

Voorbeeld 1: Een resource delen met een specifieke gebruiker

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina"

Met de eerste opdracht wordt het sjabloonobject met de naam Template01 opgehaald en wordt het object opgeslagen in de variabele $Resource.

De tweede opdracht deelt de resource die is opgeslagen in $Resource (Template01) met de gebruiker met de naam Katarina. Als de gebruiker lid is van meerdere selfservicegebruikersrollen met ontvangstmachtigingen, moet een gebruikersrol worden opgegeven.

Voorbeeld 2: Een resource delen met een gebruiker die lid is van meerdere gebruikersrollen

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")

Met de eerste opdracht wordt het sjabloonobject met de naam Template01 opgehaald en wordt het object opgeslagen in de variabele $Resource.

Met de tweede opdracht wordt de resource die is opgeslagen in $Resource (Template01) gedeeld met de gebruiker met de naam Katarina, maar alleen terwijl die gebruiker de gebruikersrollen ContosoSelfServiceUsers of SelfServiceUserRole02 gebruikt.

Voorbeeld 3: Een resource delen met alle leden van een gebruikersrol

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"

Met de eerste opdracht wordt het sjabloonobject met de naam VMTemplate01 opgehaald en wordt het object opgeslagen in de $Resource variabele.

De tweede opdracht deelt de resource die is opgeslagen in $Resource (VMTemplate01) met de leden van de gebruikersrol ContosoSelfServiceUsers.

Voorbeeld 4: Een resource delen met alle leden van een gebruikersrol met behulp van de gebruikersrol-id

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Grant-SCResource -Resource $Resource -UserRoleId $UserRole.Id

Met de eerste opdracht wordt het sjabloonobject met de naam VMTemplate01 opgehaald en wordt het object opgeslagen in de $Resource variabele.

Met de tweede opdracht wordt het gebruikersrolobject met de naam ContosoSelfServiceUsers opgehaald en wordt het object opgeslagen in de variabele $UserRole.

Met de laatste opdracht wordt de resource die is opgeslagen in $Resource (VMTemplate01) gedeeld met de leden van de gebruikersrol ContosoSelfServiceUsers.

Parameters

-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 op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

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

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. 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 met deze parameter wordt opgegeven.

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

-Resource

Hiermee geeft u een resourceobject.

Type:ClientObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-UserName

Hiermee geeft u een naam van een gebruiker. Voer een gebruikersnaam in met de notatie Domein\Gebruiker.

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

-UserRoleID

Hiermee geeft u de id van een gebruikersrol op.

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

-UserRoleName

Hiermee geeft u de naam van een gebruikersrol. Typen gebruikersrollen met de naam Gedelegeerde beheerder, Read-Only Administrator en Self-Service Gebruiker.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

Resource

Met deze cmdlet wordt een resourceobject geretourneerd.