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.
Этот командлет не создает выходные данные.