Freigeben über


Revoke-SCResource

Widerruft den Zugriff auf eine Ressource von einer Benutzer- oder Benutzerrolle.

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>]

Beschreibung

Das Cmdlet "Revoke-SCResource " widerruft den Zugriff auf eine Ressource aus einer Benutzer- oder Benutzerrolle.

Beispiele

Beispiel 1: Widerrufen des Zugriffs auf eine Ressource von einem bestimmten Benutzer

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

Der erste Befehl ruft das Vorlagenobjekt namens "Template01" ab und speichert das Objekt in der $Resource Variablen.

Der zweite Befehl widerruft den Zugriff auf die in $Resource (Template01) gespeicherte Ressource vom Benutzer mit dem Namen Katarina. Wenn der Benutzer Mitglied mehrerer Benutzerrollen ist, wird der Zugriff vom Benutzer in allen benutzerrollen widerrufen.

Beispiel 2: Widerrufen des Zugriffs auf eine Ressource von einem Benutzer, der Mitglied mehrerer Benutzerrollen ist

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

Der erste Befehl ruft das Vorlagenobjekt namens "Template01" ab und speichert das Objekt in der $Resource Variablen.

Der zweite Befehl widerruft den Zugriff auf die ressource, die in $Resource (Vorlage01) vom Benutzer namens Katarina gespeichert ist, aber nur, wenn der Benutzer die Rollen "ContosoSelfServiceUsers" oder "SelfServiceUserRole02" verwendet. Wenn Katarina eine andere Benutzerrolle verwendet, die Zugriff auf die Ressource hat, kann sie weiterhin auf die Ressource zugreifen.

Beispiel 3: Widerrufen des Zugriffs auf eine Ressource aus allen Mitgliedern einer Benutzerrolle

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

Der erste Befehl ruft das Vorlagenobjekt namens "Template01" ab und speichert das Objekt in der $Resource Variablen.

Der zweite Befehl widerruft den Zugriff auf die in $Resource (Template01) gespeicherte Ressource von allen Mitgliedern der Benutzerrolle ContosoSelfServiceUsers.

Parameter

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Resource

Gibt ein Ressourcenobjekt an.

Typ:ClientObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

Gibt einen Namen eines Benutzers an. Geben Sie einen Benutzernamen mit dem Format "Domäne\Benutzer" ein.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRoleID

Gibt die ID einer Benutzerrolle an.

Typ:Guid[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRoleName

Gibt den Namen einer Benutzerrolle an. Typen von Benutzerrollen, die benannt werden, umfassen delegierten Administrator, Read-Only Administrator und Self-Service Benutzer.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

Resource

Dieses Cmdlet gibt ein Resource-Objekt zurück.