Get-SCSMUserRole
Извлекает роли пользователей, определенные в Service Manager.
Синтаксис
Get-SCSMUserRole
[[-DisplayName] <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCSMUserRole
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Get-SCSMUserRole
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>] Описание
Командлет Get-SCSMUserRole извлекает профили ролей пользователей, определенные в Service Manager. Затем этот список можно использовать для добавления пользователей в один из профилей роли пользователя. При необходимости можно предоставить регулярное выражение для поиска определенного профиля роли пользователя.
Примеры
Пример 1. Получение ролей пользователя для локального компьютера
PS C:\>Get-SCSMUserRole
Name Description LastModified LastModifiedBy
---- ----------- ------------ --------------
ChangeManagers The Service Manager Change... 6/14/2010 5:14:16 AM
IncidentResolvers The Service Manager Incide... 6/14/2010 5:14:16 AM
ActivityImplementers The Service Manager Activi... 6/14/2010 5:14:15 AM
Workflows The Service Manager Workfl... 6/14/2010 5:14:16 AM
Administrators The Service Manager Admini... 6/14/2010 5:14:16 AM
ProblemAnalysts The Service Manager Proble... 6/14/2010 5:14:16 AM
AdvancedOperators The Service Manager Advanc... 6/14/2010 5:14:16 AM
Authors The Service Manager Author... 6/14/2010 5:14:16 AM
ChangeInitiators The Service Manager Change... 6/14/2010 5:14:16 AM
ReadOnlyOperators The Service Manager Read-O... 6/14/2010 5:14:16 AM
EndUsers The Service Manager End Us... 6/14/2010 5:14:16 AMЭта команда извлекает список ролей пользователей с локального компьютера.
Пример 2. Получение роли "Администраторы"
PS C:\>Get-SCSMUserRole -Name "Administrators"
Name Description LastModified LastModifiedBy
---- ----------- ------------ --------------
Administrators The Service Manager Admini... 6/14/2010 5:14:16 AMЭта команда извлекает роль пользователя "Администраторы".
Пример 3. Отображение классов роли
PS C:\>$Role = Get-SCSMUserRole -DisplayName "CustomRole"
PS C:\> $Role
DisplayName Description LastModified LastModifiedBy
----------- ----------- ------------ --------------
CustomRole Custom Description 8/6/2010 12:23:46 AM WOODGROVE\Administrator PS C:\>$Role.Classes
Abstract Name DisplayName
-------- ---- -----------
True Microsoft.SystemCenter.ServiceDesigner.Messaging.Storage Storage
True Microsoft.SystemCenter.ServiceDesigner.ServiceComponentGroup Distributed Application Component
False Microsoft.SystemCenter.StorageDevicesGroup Storage Devices Group
True Microsoft.SystemCenter.ServiceDesigner.WebApplication Line of Business Web Application
True Microsoft.SystemCenter.ConfigItemGroup All Groups
False System.WorkItem.Incident Incident
True Microsoft.SystemCenter.ServiceDesigner.Messaging Messaging
True Microsoft.SystemCenter.InstanceGroup All Instance Groups
True Microsoft.SystemCenter.ServiceDesigner.WebApplication.WebSiteGroup Web Application Web Sites
True Microsoft.SystemCenter.ServiceDesigner.WebApplication.DatabaseGroup Web Application Databases
True Microsoft.SystemCenter.ServiceDesigner.GenericService Blank
True Microsoft.SystemCenter.ServiceDesigner.Service User Created Distributed Application
False Microsoft.SystemCenter.BusinessService Business ServiceПервая команда получает роль пользователя с именем CustomRole, а затем сохраняет ее в переменной $Role.
Вторая команда отображает содержимое $Role.
Третья команда отображает классы $Role.
Параметры
-ComputerName
Указывает имя компьютера, на котором выполняется служба доступа к данным System Center.
Учетная запись пользователя, указанная в параметре учетных данных
| Тип: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Credential
Указывает учетные данные, которые этот командлет использует для подключения к серверу, на котором выполняется служба доступа к данным System Center. Указанная учетная запись пользователя должна иметь права доступа к серверу.
| Тип: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisplayName
Указывает отображаемое имя извлекаемой роли пользователя. Можно указать регулярное выражение.
| Тип: | System.String[] |
| Position: | 0 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Id
Указывает идентификатор извлекаемой роли пользователя.
| Тип: | System.Guid[] |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Name
Указывает имя извлекаемой роли пользователя. Можно указать регулярное выражение.
| Тип: | System.String[] |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SCSession
Указывает объект, представляющий сеанс на сервере управления Service Manager.
| Тип: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
System.String
Имя можно передать в параметр DisplayName.
System.Guid
Guid можно передать в параметр id.
Выходные данные
Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
Объект UserRole предоставляет сведения о ролях пользователей Service Manager. Этот объект можно использовать вместе с командлетом Update-SCSMUserRole для добавления пользователя в роль пользователя.