Sdílet prostřednictvím

Grant-SCResource

  • Reference
Modul:
VirtualMachineManager

Udělí uživateli nebo samoobslužné roli uživatele přístup k prostředku.

Syntaxe

Grant-SCResource
     [-VMMServer <ServerConnection>]
     -Resource <ClientObject>
     [-UserRoleName <String[]>]
     [-UserRoleID <Guid[]>]
     [-UserName <String>]
     [-JobGroup <Guid>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-OnBehalfOfUser <String>]
     [-OnBehalfOfUserRole <UserRole>]
     [<CommonParameters>]

Description

Rutina Grant-SCResource uděluje uživateli nebo samoobslužné roli uživatele přístup k prostředku.

Typy prostředků, které můžete sdílet pomocí Grant-SCResource zahrnují následující:

  • Šablony služeb

  • Šablony virtuálních počítačů

  • Profily hostovaného operačního systému

  • Profily SQL Serveru

  • Hardwarové profily

  • Profily aplikací

  • Služby

  • Virtuální počítače

Příklady

Příklad 1: Sdílení prostředku s konkrétním uživatelem

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

První příkaz získá objekt šablony s názvem Template01 a uloží objekt do $Resource proměnné.

Druhý příkaz sdílí prostředek uložený v $Resource (Template01) s uživatelem Katarina. Pokud je uživatel členem více rolí samoobslužných uživatelů s oprávněním k přijetí, musí být zadána role uživatele.

Příklad 2: Sdílení prostředku s uživatelem, který je členem více uživatelských rolí

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

První příkaz získá objekt šablony s názvem Template01 a uloží objekt do $Resource proměnné.

Druhý příkaz sdílí prostředek uložený v $Resource (Template01) s uživatelem Katarina, ale pouze když tento uživatel používá role uživatelů ContosoSelfServiceUsers nebo SelfServiceUserRole02.

Příklad 3: Sdílení prostředku se všemi členy role uživatele

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

První příkaz získá objekt šablony s názvem VMTemplate01 a uloží objekt do $Resource proměnné.

Druhý příkaz sdílí prostředek uložený v $Resource (VMTemplate01) se členy role uživatele s názvem ContosoSelfServiceUsers.

Příklad 4: Sdílení prostředku se všemi členy role uživatele pomocí ID role uživatele

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

První příkaz získá objekt šablony s názvem VMTemplate01 a uloží objekt do $Resource proměnné.

Druhý příkaz získá objekt role uživatele s názvem ContosoSelfServiceUsers a uloží objekt do $UserRole proměnné.

Poslední příkaz sdílí prostředek uložený v $Resource (VMTemplate01) se členy role uživatele ContosoSelfServiceUsers.

Parametry

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Resource

Určuje objekt prostředku.

Typ:ClientObject
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserName

Určuje jméno uživatele. Zadejte uživatelské jméno ve formátu Domain\User.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserRoleID

Určuje ID role uživatele.

Typ:Guid[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UserRoleName

Určuje název role uživatele. Typy uživatelských rolí, které mají název, zahrnují delegovaného správce, Read-Only správce a uživatele Self-Service.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

Resource

Tato rutina vrátí objekt Resource.