Revoke-SCResource
Отменяет доступ к ресурсу из роли пользователя или пользователя.
Синтаксис
Revoke-SCResource
[-VMMServer <ServerConnection>]
-Resource <ClientObject>
[-UserRoleName <String[]>]
[-UserRoleID <Guid[]>]
[-UserName <String>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Описание
Командлет Revoke-SCResource отменяет доступ к ресурсу из роли пользователя или пользователя.
Примеры
Пример 1. Отзыв доступа к ресурсу у конкретного пользователя
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -Username "Contoso\Katarina"
Первая команда получает объект шаблона с именем Template01 и сохраняет его в переменной $Resource.
Вторая команда отменяет доступ к ресурсу, хранящейся в $Resource (Template01), у пользователя с именем Katarina. Если пользователь является членом нескольких ролей пользователей, доступ будет отозван пользователем во всех его ролях.
Пример 2. Отзыв доступа к ресурсу у пользователя, который является членом нескольких ролей пользователей
PS C:\> $Resource = Get-SCVMTemplate | where {$_.Name -eq "Template01"}
PS C:\> Revoke-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 "Template01"}
PS C:\> Revoke-SCResource -Resource $Resource -UserRoleName "ContosoSelfServiceUsers"
Первая команда получает объект шаблона с именем Template01 и сохраняет его в переменной $Resource.
Вторая команда отменяет доступ к ресурсу, хранящейся в $Resource (Template01), от всех членов роли пользователя 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 .