Grant-SCResource
Udělí uživateli nebo samoobslužné roli uživatele přístup k prostředku.
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>]
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ího počítače
Profily hostovaného operačního systému
profily SQL Server
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 proměnné $Resource.
Druhý příkaz sdílí prostředek uložený v $Resource (Template01) s uživatelem s názvem Katarina. Pokud je uživatel členem více rolí samoobslužných uživatelů s oprávněním k příjmu, musí být zadána role uživatele.
Příklad 2: Sdílení prostředku s uživatelem, který je členem více rolí uživatelů
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 proměnné $Resource.
Druhý příkaz sdílí prostředek uložený v $Resource (Template01) s uživatelem s názvem Katarina, ale pouze v době, 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 proměnné $Resource.
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 proměnné $Resource.
Druhý příkaz získá objekt role uživatele s názvem ContosoSelfServiceUsers a uloží objekt do proměnné $UserRole.
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ý identifikátor skupiny úloh.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Určuje uživatelské jméno. Tato rutina pracuje jménem uživatele, kterého tento parametr určuje.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Určuje roli uživatele. K získání role uživatele použijte rutinu Get-SCUserRole . Tato rutina pracuje jménem role uživatele, kterou tento parametr určuje.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Resource
Určuje objekt prostředku.
Type: | ClientObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RunAsynchronously
Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Určuje jméno uživatele. Zadejte uživatelské jméno s formátem Domain\User.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleID
Určuje ID role uživatele.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleName
Určuje název role uživatele. Mezi typy uživatelských rolí, které mají název, patří Delegovaný správce, Read-Only Správce a Self-Service Uživatel.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Určuje objekt serveru VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Výstupy
Resource
Tato rutina vrátí objekt Resource .