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

Revoke-SCResource

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

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

Синтаксис

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

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

Тип: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 .