Поделиться через

Grant-SCResource

  • Ссылка
Модуль:
VirtualMachineManager

Предоставляет пользователю или самостоятельной роли пользователя доступ к ресурсу.

Синтаксис

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

Описание

Командлет Grant-SCResource предоставляет пользователю или самостоятельной роли пользователя доступ к ресурсу.

Типы ресурсов, к которым можно предоставить общий доступ с помощью Grant-SCResource , относятся следующие:

  • Шаблоны служб

  • Шаблоны виртуальных машин

  • Профили операционной системы на виртуальной машине

  • профили SQL Server

  • Профили оборудования

  • Профили приложений

  • Службы

  • Виртуальные машины

Примеры

Пример 1. Предоставление доступа к ресурсу определенному пользователю

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

Первая команда получает объект шаблона с именем Template01 и сохраняет его в переменной $Resource.

Вторая команда использует ресурс, хранящийся в $Resource (Template01), с пользователем с именем Katarina. Если пользователь является членом нескольких ролей пользователей самообслуживания с разрешением на получение, необходимо указать роль пользователя.

Пример 2. Предоставление общего доступа к ресурсу пользователю, который является членом нескольких ролей пользователей

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

Первая команда получает объект шаблона с именем Template01 и сохраняет его в переменной $Resource.

Вторая команда использует ресурс, хранящийся в $Resource (Template01), с пользователем с именем Katarina, но только в то время как этот пользователь использует роли пользователей ContosoSelfServiceUsers или SelfServiceUserRole02.

Пример 3. Предоставление общего доступа к ресурсу всем членам роли пользователя

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

Первая команда получает объект шаблона с именем VMTemplate01 и сохраняет объект в переменной $Resource.

Вторая команда совместно использует ресурс, хранящийся в $Resource (VMTemplate01), с членами роли пользователя с именем ContosoSelfServiceUsers.

Пример 4. Предоставление общего доступа к ресурсу всем членам роли пользователя с помощью идентификатора роли пользователя

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

Первая команда получает объект шаблона с именем VMTemplate01 и сохраняет объект в переменной $Resource.

Вторая команда получает объект роли пользователя с именем ContosoSelfServiceUsers и сохраняет объект в переменной $UserRole.

Последняя команда использует ресурс, хранящийся в $Resource (VMTemplate01), с членами роли пользователя ContosoSelfServiceUsers.

Параметры

-JobGroup

Указывает идентификатор для ряда команд, которые будут выполняться как набор непосредственно перед окончательной командой, которая включает тот же идентификатор группы заданий.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного этим параметром.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной этим параметром.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проводить аудит советов PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Resource

Указывает объект ресурса.

Type:ClientObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы управление немедленно возвращалось в командную оболочку.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserName

Указывает имя пользователя. Введите имя пользователя в формате Domain\User.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleID

Указывает идентификатор роли пользователя.

Type:Guid[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleName

Указывает имя роли пользователя. Типы именованных ролей пользователей включают делегированного администратора, администратора Read-Only и пользователя Self-Service.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Указывает объект сервера VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Выходные данные

Resource

Этот командлет возвращает объект Resource .