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 einem Self-Service-Benutzerrollenzugriff auf eine Ressource.

Typen von Ressourcen, die Sie mit Grant-SCResource teilen können, folgendes umfassen:

  • Dienstvorlagen

  • Vorlagen für virtuelle Computer

  • Gastbetriebssystemprofile

  • 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 mit dem Namen Template01 ab und speichert das Objekt in der variablen $Resource.

Der zweite Befehl teilt die in $Resource (Template01) gespeicherte Ressource mit dem Benutzer "Katarina". Wenn der Benutzer Mitglied mehrerer Self-Service-Benutzerrollen mit Empfangsberechtigung ist, 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 mit dem Namen Template01 ab und speichert das Objekt in der variablen $Resource.

Der zweite Befehl teilt die in $Resource (Template01) gespeicherte Ressource mit dem Benutzer Katarina, aber nur, wenn dieser Benutzer die Benutzerrollen "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 variablen $Resource.

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 variablen $Resource.

Der zweite Befehl ruft das Benutzerrollenobjekt namens 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 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.