Grant-SCResource
Предоставляет пользователю или самостоятельному пользователю доступ к ресурсу.
Синтаксис
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
Указывает идентификатор для ряда команд, которые будут выполняться как набор непосредственно перед окончательной командой, которая включает тот же идентификатор группы заданий.
Тип: | Guid |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного этим параметром.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-OnBehalfOfUserRole
Указывает роль пользователя.
Чтобы получить роль пользователя, используйте командлет Get-SCUserRole
Тип: | UserRole |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.
Тип: | Guid |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Resource
Указывает объект ресурса.
Тип: | ClientObject |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserName
Указывает имя пользователя. Введите имя пользователя с форматом Domain\User.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserRoleID
Указывает идентификатор роли пользователя.
Тип: | Guid[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-UserRoleName
Указывает имя роли пользователя. Типы ролей пользователей, которые называются делегированным администратором, администратором Read-Only и пользователем Self-Service.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VMMServer
Указывает объект сервера VMM.
Тип: | ServerConnection |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Выходные данные
Resource
Этот командлет возвращает объект resource