Grant-SCResource
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.