Get-SCSMUserRole
Recupera funções de usuário definidas no Service Manager.
Sintaxe
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>] Description
O cmdlet Get-SCSMUserRole recupera perfis de função de usuário definidos no Service Manager. Em seguida, você pode usar essa lista para adicionar usuários a um dos perfis de função de usuário. Opcionalmente, você pode fornecer uma expressão regular para pesquisar um perfil de função de usuário específico.
Exemplos
Exemplo 1: Obter as funções de usuário para o computador local
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 AMEste comando recupera a lista de funções de usuário do computador local.
Exemplo 2: Obter a função Administradores
PS C:\>Get-SCSMUserRole -Name "Administrators"
Name Description LastModified LastModifiedBy
---- ----------- ------------ --------------
Administrators The Service Manager Admini... 6/14/2010 5:14:16 AMEste comando recupera a função de usuário Administradores.
Exemplo 3: Exibir as classes de uma função
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 ServiceO primeiro comando obtém a função de usuário chamada CustomRole e, em seguida, armazena-a na variável $Role.
O segundo comando exibe o conteúdo de $Role.
O terceiro comando exibe as classes de $Role.
Parâmetros
-ComputerName
Especifica o nome do computador no qual o serviço de Acesso a Dados do System Center é executado. A conta de usuário especificada no parâmetro Credential deve ter direitos de acesso ao computador especificado.
| Tipo: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Credential
Especifica as credenciais que esse cmdlet usa para se conectar ao servidor no qual o serviço de Acesso a Dados do System Center é executado. A conta de usuário especificada deve ter direitos de acesso a esse servidor.
| Tipo: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DisplayName
Especifica o nome para exibição da função de usuário a ser recuperada. Você pode especificar uma expressão regular.
| Tipo: | System.String[] |
| Position: | 0 |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Id
Especifica a ID da função de usuário a ser recuperada.
| Tipo: | System.Guid[] |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Name
Especifica o nome da função de usuário a ser recuperada. Você pode especificar uma expressão regular.
| Tipo: | System.String[] |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-SCSession
Especifica um objeto que representa uma sessão para um servidor de gerenciamento do Service Manager.
| Tipo: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
System.String
Você pode canalizar um nome para o parâmetro DisplayName.
System.Guid
Você pode canalizar um GUID para o parâmetro Id.
Saídas
Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role
O objeto UserRole fornece as informações sobre as funções de usuário do Service Manager. Esse objeto pode ser usado em conjunto com o cmdlet Update-SCSMUserRole para adicionar um usuário a uma função de usuário.