Revoke-SCResource
Hiermee wordt de toegang tot een resource van een gebruiker of gebruikersrol ingetrokken.
Syntax
Revoke-SCResource
[-VMMServer <ServerConnection>]
-Resource <ClientObject>
[-UserRoleName <String[]>]
[-UserRoleID <Guid[]>]
[-UserName <String>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
Met de cmdlet Revoke-SCResource wordt de toegang tot een resource van een gebruiker of gebruikersrol ingetrokken.
Voorbeelden
Voorbeeld 1: De toegang tot een resource intrekken van een specifieke gebruiker
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 $Resource variabele.
Met de tweede opdracht wordt de toegang tot de resource die is opgeslagen in $Resource (Template01) van de gebruiker met de naam Katarina ingetrokken. Als de gebruiker lid is van meerdere gebruikersrollen, wordt de toegang ingetrokken van de gebruiker in alle gebruikersrollen.
Voorbeeld 2: De toegang tot een resource intrekken van een gebruiker die lid is van meerdere gebruikersrollen
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 $Resource variabele.
Met de tweede opdracht wordt de toegang tot de resource ingetrokken die is opgeslagen in $Resource (Template01) van de gebruiker met de naam Katarina, maar alleen als de gebruiker de gebruikersrollen ContosoSelfServiceUsers of SelfServiceUserRole02 gebruikt. Als Katarina een andere gebruikersrol gebruikt die toegang heeft tot de resource, heeft ze nog steeds toegang tot de resource.
Voorbeeld 3: De toegang tot een resource intrekken van alle leden van een gebruikersrol
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"
Met de eerste opdracht wordt het sjabloonobject met de naam Template01 opgehaald en wordt het object opgeslagen in de $Resource variabele.
Met de tweede opdracht wordt de toegang tot de resource die is opgeslagen in $Resource (Template01) van alle leden van de gebruikersrol ContosoSelfServiceUsers ingetrokken.
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 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 |
-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 op.
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 op. 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.