Compartilhar via

Get-SCSMUserRole

Módulo:
System.Center.Service.Manager Module

Recupera as funções de usuário definidas no Service Manager.

Sintaxe

FromDisplayName (Padrão) 

Get-SCSMUserRole
    [[-DisplayName] <String[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromId 

Get-SCSMUserRole
    [-Id] <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromName 

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 AM

Esse 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 AM

Esse 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 Service

O primeiro comando obtém a função de usuário chamada CustomRole e, em seguida, a armazena 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.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:Localhost
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:System.Management.Automation.PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisplayName

Especifica o nome de exibição da função de usuário a ser recuperada. Você pode especificar uma expressão regular.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromDisplayName
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

Especifica a ID da função de usuário a ser recuperada.

Propriedades do parâmetro

Tipo:

System.Guid[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromId
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome da função de usuário a ser recuperada. Você pode especificar uma expressão regular.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

FromName
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SCSession

Especifica um objeto que representa uma sessão para um servidor de gerenciamento do Service Manager.

Propriedades do parâmetro

Tipo:

Microsoft.SystemCenter.Core.Connection.Connection[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

System.String

Você pode canalizar um nome para o parâmetro DisplayName.

System.Guid

Você pode redirecionar um GUID para o parâmetro de ID do .

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.