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 von 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 mit dem Namen Template01 ab und speichert das Objekt in der variablen $Resource.
Mit dem zweiten Befehl wird der Zugriff auf die in $Resource (Template01) gespeicherte Ressource vom Benutzer Katarina widerrufen. 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 mit dem Namen Template01 ab und speichert das Objekt in der variablen $Resource.
Mit dem zweiten Befehl wird der Zugriff auf die in $Resource (Template01) gespeicherte Ressource vom Benutzer Katarina widerrufen, aber nur, wenn der Benutzer die Benutzerrollen "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 von 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 mit dem Namen Template01 ab und speichert das Objekt in der variablen $Resource.
Mit dem zweiten Befehl wird der Zugriff auf die in $Resource (Template01) gespeicherte Ressource von allen Mitgliedern der Benutzerrolle "ContosoSelfServiceUsers" widerrufen.
Parameter
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobVariable
Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag 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. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag 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 den 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.