Grant-SCResource
Przyznaje użytkownikowi lub samoobsługowemu użytkownikowi dostęp do zasobu.
Składnia
Grant-SCResource
[-VMMServer <ServerConnection>]
-Resource <ClientObject>
[-UserRoleName <String[]>]
[-UserRoleID <Guid[]>]
[-UserName <String>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Opis
Polecenie cmdlet Grant-SCResource udziela użytkownikowi lub samoobsługowej roli użytkownika dostępu do zasobu.
Typy zasobów, które można udostępniać przy użyciu programu Grant-SCResource , obejmują następujące elementy:
Szablony usług
Szablony maszyn wirtualnych
Profile systemu operacyjnego gościa
profile SQL Server
Profile sprzętu
Profile aplikacji
Usługi
Maszyny wirtualne
Przykłady
Przykład 1. Udostępnianie zasobu określonego użytkownika
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina"
Pierwsze polecenie pobiera obiekt szablonu o nazwie Template01 i przechowuje obiekt w zmiennej $Resource.
Drugie polecenie udostępnia zasób przechowywany w $Resource (Template01) użytkownikowi o nazwie Katarina. Jeśli użytkownik jest członkiem wielu ról użytkownika samoobsługi z uprawnieniem odbioru, należy określić rolę użytkownika.
Przykład 2. Udostępnianie zasobu użytkownikowi, który jest członkiem wielu ról użytkowników
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Grant-SCResource -Resource $Resource -Username "Contoso\Katarina" -UserRoleName @("ContosoSelfServiceUsers", "SelfServiceUserRole02")
Pierwsze polecenie pobiera obiekt szablonu o nazwie Template01 i przechowuje obiekt w zmiennej $Resource.
Drugie polecenie udostępnia zasób przechowywany w $Resource (Template01) użytkownikowi o nazwie Katarina, ale tylko wtedy, gdy ten użytkownik korzysta z ról użytkownika ContosoSelfServiceUsers lub SelfServiceUserRole02.
Przykład 3. Udostępnianie zasobu wszystkim członkom roli użytkownika
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Grant-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"
Pierwsze polecenie pobiera obiekt szablonu o nazwie VMTemplate01 i przechowuje obiekt w zmiennej $Resource.
Drugie polecenie udostępnia zasób przechowywany w $Resource (VMTemplate01) z członkami roli użytkownika o nazwie ContosoSelfServiceUsers.
Przykład 4. Udostępnianie zasobu wszystkim członkom roli użytkownika przy użyciu identyfikatora roli użytkownika
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
Pierwsze polecenie pobiera obiekt szablonu o nazwie VMTemplate01 i przechowuje obiekt w zmiennej $Resource.
Drugie polecenie pobiera obiekt roli użytkownika o nazwie ContosoSelfServiceUsers i przechowuje obiekt w zmiennej $UserRole.
Ostatnie polecenie udostępnia zasób przechowywany w $Resource (VMTemplate01) członkom roli użytkownika ContosoSelfServiceUsers.
Parametry
-JobGroup
Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Resource
Określa obiekt zasobu.
Type: | ClientObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Określa nazwę użytkownika. Wprowadź nazwę użytkownika w formacie Domena\Użytkownik.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleID
Określa identyfikator roli użytkownika.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserRoleName
Określa nazwę roli użytkownika. Typy ról użytkowników o nazwach obejmują administratora delegowanego, administratora Read-Only i użytkownika Self-Service.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Określa obiekt serwera programu VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wyjściowe
Resource
To polecenie cmdlet zwraca obiekt Resource .