Update-SCSMUserRole

Задает свойство UserRole для пользователя Service Manager.

Синтаксис

Default (по умолчанию)

Update-SCSMUserRole
    [-UserRole] <Role[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Update-SCSMUserRole задает свойство UserRole для пользователя Service Manager.

Примеры

Пример 1. Добавление пользователя в роль пользователя

PS C:\>$Role = Get-SCSMUserRole -Name "IncidentResolvers"
PS C:\> $User = Get-SCSMUser -UserName "PattiFuller"
PS C:\> $Role.User += $User
PS C:\> Update-SCSMUserRole -Role $Role

Первая команда получает роль пользователя с именем IncidentResolvers с помощью Get-SCSMUserRole, а затем сохраняет ее в переменной $Role.

Вторая команда получает пользователя с помощью командлета Get-SCSMUser, а затем сохраняет этот объект в переменной $User.

Третья команда добавляет $User к свойству User $Role.

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

Пример 2. Удаление пользователя из роли

PS C:\>Get-SCSMUserRole -Name "Administrators"
WOODGROVE\Administrator
WOODGROVE\Domain Admins


The second command assigns the user role previously displayed to the $Role variable.
PS C:\>$Role = Get-SCSMUserRole -Name "Administrators"

The third command assigns the first user role to the **User** property of $Role. This command that property, removing all except the specified user.
PS C:\>$Role.User = $Role.Users[0]

The final command updates the role to match the current value of $Role.
PS C:\>Update-SCSMUserRole -Role $Role

В этом примере пользователь удаляется из роли пользователя. Первая команда отображает администраторов.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PassThru

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

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UserRole

Указывает объект UserRole, в который необходимо добавить пользователя.

Свойства параметра

Тип:

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

Можно передать объект UserRole в параметр UserRole. Чтобы получить роль пользователя, используйте командлет Get-SCSMUserRole.

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

None.

Этот командлет не создает выходные данные.