Get-SCSMUserRole

Módulo:

System.Center.Service.Manager

Recupera los roles de usuario definidos en Service Manager.

Sintaxis

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

El cmdlet Get-SCSMUserRole recupera los perfiles de rol de usuario definidos en Service Manager. A continuación, puede usar esta lista para agregar usuarios a uno de los perfiles de rol de usuario. Opcionalmente, puede proporcionar una expresión regular para buscar un perfil de rol de usuario específico.

Ejemplos

Ejemplo 1: Obtención de los roles de usuario para el equipo 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

Este comando recupera la lista de roles de usuario del equipo local.

Ejemplo 2: Obtención del rol Administradores

PS C:\>Get-SCSMUserRole -Name "Administrators"
Name                          Description                   LastModified                  LastModifiedBy
----                          -----------                   ------------                  --------------
Administrators                The Service Manager Admini... 6/14/2010 5:14:16 AM

Este comando recupera el rol de usuario Administradores.

Ejemplo 3: Mostrar las clases de un rol

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

El primer comando obtiene el rol de usuario denominado CustomRole y, a continuación, lo almacena en la variable $Role.

El segundo comando muestra el contenido de $Role.

El tercer comando muestra las clases de $Role.

Parámetros

-ComputerName

Especifica el nombre del equipo en el que se ejecuta el servicio de acceso a datos de System Center. La cuenta de usuario especificada en el parámetro credential debe tener derechos de acceso al equipo especificado.

Tipo:	System.String[]
Posición:	Named
Valor predeterminado:	Localhost
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

Especifica las credenciales que usa este cmdlet para conectarse al servidor en el que se ejecuta el servicio de acceso a datos de System Center. La cuenta de usuario especificada debe tener derechos de acceso a ese servidor.

Tipo:	System.Management.Automation.PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisplayName

Especifica el nombre para mostrar del rol de usuario que se va a recuperar. Puede especificar una expresión regular.

Tipo:	System.String[]
Posición:	0
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Id

Especifica el identificador del rol de usuario que se va a recuperar.

Tipo:	System.Guid[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Especifica el nombre del rol de usuario que se va a recuperar. Puede especificar una expresión regular.

Tipo:	System.String[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SCSession

Especifica un objeto que representa una sesión en un servidor de administración de Service Manager.

Tipo:	Microsoft.SystemCenter.Core.Connection.Connection[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

System.String

Puede canalizar un nombre al parámetro DisplayName.

System.Guid

Puede canalizar un GUID al parámetro Id.

Salidas

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

El objeto UserRole proporciona la información sobre los roles de usuario de Service Manager. Este objeto se puede usar junto con el cmdlet Update-SCSMUserRole para agregar un usuario a un rol de usuario.

Vínculos relacionados

• New-SCSMUserRole
• Remove-SCSMUserRole
• Update-SCSMUserRole