Freigeben über

Grant-SCResource

  • Referenz
Modul:
VirtualMachineManager

Gewährt einem Benutzer oder einer Self-Service-Benutzerrolle Zugriff auf eine Ressource.

Syntax

Grant-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 Grant-SCResource gewährt einem Benutzer oder einer Self-Service-Benutzerrolle Zugriff auf eine Ressource.

Typen von Ressourcen, die Sie mithilfe von Grant-SCResource freigeben können, umfassen Folgendes:

  • Dienstvorlagen

  • Vorlagen für virtuelle Maschinen

  • Gastbetriebssystem-Profile

  • SQL Server Profile

  • Hardwareprofile

  • Anwendungsprofile

  • Dienste

  • Virtuelle Computer

Beispiele

Beispiel 1: Freigeben einer Ressource für einen bestimmten Benutzer

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-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 teilt die in $Resource (Template01) gespeicherte Ressource mit dem Namen Katarina. Wenn der Benutzer Mitglied mehrerer Self-Service-Benutzerrollen ist, die die Berechtigung erhalten, muss eine Benutzerrolle angegeben werden.

Beispiel 2: Freigeben einer Ressource für einen Benutzer, der Mitglied mehrerer Benutzerrollen ist

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-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 teilt die ressource, die in $Resource (Template01) mit dem Benutzer namens Katarina gespeichert ist, aber nur, wenn dieser Benutzer die Rollen "ContosoSelfServiceUsers" oder "SelfServiceUserRole02" verwendet.

Beispiel 3: Freigeben einer Ressource für alle Mitglieder einer Benutzerrolle

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

Der erste Befehl ruft das Vorlagenobjekt mit dem Namen VMTemplate01 ab und speichert das Objekt in der $Resource Variablen.

Der zweite Befehl teilt die in $Resource (VMTemplate01) gespeicherte Ressource mit den Mitgliedern der Benutzerrolle "ContosoSelfServiceUsers".

Beispiel 4: Freigeben einer Ressource für alle Mitglieder einer Benutzerrolle mithilfe der Benutzerrollen-ID

PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $UserRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Grant-SCResource -Resource $Resource -UserRoleId $UserRole.Id

Der erste Befehl ruft das Vorlagenobjekt mit dem Namen VMTemplate01 ab und speichert das Objekt in der $Resource Variablen.

Der zweite Befehl ruft das Benutzerrollenobjekt "ContosoSelfServiceUsers" ab und speichert das Objekt in der $UserRole Variablen.

Der letzte Befehl teilt die in $Resource (VMTemplate01) gespeicherte Ressource mit den 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.