Revoke-SCResource
Hiermee wordt de toegang tot een resource vanuit een gebruikers- of gebruikersrol ingetrokken.
Syntaxis
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 vanuit een gebruikers- 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 variabele $Resource.
Met de tweede opdracht wordt de toegang tot de resource ingetrokken die is opgeslagen in $Resource (Template01) van de gebruiker met de naam Katarina. Als de gebruiker lid is van meerdere gebruikersrollen, wordt de toegang van de gebruiker in alle gebruikersrollen ingetrokken.
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 variabele $Resource.
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 variabele $Resource.
Met de tweede opdracht wordt de toegang tot de resource ingetrokken die is opgeslagen in $Resource (Template01) van alle 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-OnBehalfOfUser
Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Resource
Hiermee geeft u een resourceobject.
Type: | ClientObject |
Position: | Named |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UserName
Hiermee geeft u een naam van een gebruiker. Voer een gebruikersnaam in met de indeling Domein\Gebruiker.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-UserRoleID
Hiermee geeft u de id van een gebruikersrol op.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-VMMServer
Hiermee geeft u een VMM-serverobject.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Uitvoerwaarden
Resource
Deze cmdlet retourneert een Resource-object.