Remove-SCSMUserRole
Удаляет роль пользователя из Service Manager.
Синтаксис
Default (по умолчанию)
Remove-SCSMUserRole
[-UserRole] <Role[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет remove-SCSMUserRole удаляет роль пользователя из Service Manager. Некоторые роли пользователей назначаются как системные роли пользователей и не могут быть удалены. Чтобы отобразить атрибут всех объектов роли пользователя, можно выполнить следующую команду.
Get-SCSMUserRole | Format-Table -Property DisplayName,{$_.userrole.issystem} -AutoSize
Если роль пользователя не может быть удалена, этот командлет возвращает неисключаемую ошибку.
Примеры
Пример 1. Удаление роли пользователя
PS C:\>Get-SCSMUserRole -Name "CustomUser" | Remove-SCSMUserRole
Эта команда получает роль пользователя с именем CustomUser с помощью командлета Get-SCSMUserRole. Команда передает этот объект текущему командлету с помощью оператора конвейера. Этот командлет удаляет эту роль пользователя.
Параметры
-Confirm
Запрашивает подтверждение перед запуском командлета.
Свойства параметра
| Тип: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(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. Например, объект, который возвращается командлетом Get-SCSMUserRole.
Выходные данные
None.
Этот командлет не создает выходные данные.