Grant-SCResource
Предоставляет пользователю или пользователю самообслуживания доступ к ресурсу.
Синтаксис
Default (по умолчанию)
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), пользователю с именем Катарина, но только в то время, когда этот пользователь использует роли пользователя 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного в этом параметре.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.
Свойства параметра
| Тип: | UserRole |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Resource
Указывает объект ресурса.
Свойства параметра
| Тип: | ClientObject |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserName
Указывает имя пользователя. Введите имя пользователя в формате Домен\Пользователь.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserRoleID
Указывает идентификатор роли пользователя.
Свойства параметра
| Тип: | Guid[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-UserRoleName
Указывает имя роли пользователя. К именованным типам ролей пользователей относятся «Делегированный администратор», «Администратор Read-Only» и «Self-Service пользователь».
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMMServer
Указывает объект сервера VMM.
Свойства параметра
| Тип: | ServerConnection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Выходные данные
Resource
Этот командлет возвращает объект Resource .