Delen via


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.