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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Resource
Gibt ein Ressourcenobjekt an.
| Type: | ClientObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
Gibt einen Namen eines Benutzers an. Geben Sie einen Benutzernamen mit dem Format "Domäne\Benutzer" ein.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleID
Gibt die ID einer Benutzerrolle an.
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRoleName
Gibt den Namen einer Benutzerrolle an. Typen von Benutzerrollen, die benannt werden, umfassen delegierten Administrator, Read-Only Administrator und Self-Service Benutzer.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
Resource
Dieses Cmdlet gibt ein Resource-Objekt zurück.