Partager via

Get-SCSMUserRole

  • Référence
Module:
System.Center.Service.Manager

Récupère les rôles d’utilisateur définis dans Service Manager.

Syntaxe

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

L’applet de commande Get-SCSMUserRole récupère les profils de rôle utilisateur définis dans Service Manager. Vous pouvez ensuite utiliser cette liste pour ajouter des utilisateurs à l’un des profils de rôle d’utilisateur. Si vous le souhaitez, vous pouvez fournir une expression régulière pour rechercher un profil de rôle d’utilisateur spécifique.

Exemples

Exemple 1 : Obtenir les rôles d’utilisateur pour l’ordinateur 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

Cette commande récupère la liste des rôles d’utilisateur à partir de l’ordinateur local.

Exemple 2 : Obtenir le rôle Administrateurs

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

Cette commande récupère le rôle d’utilisateur Administrateurs.

Exemple 3 : Afficher les classes d’un rôle

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

La première commande obtient le rôle d’utilisateur nommé CustomRole, puis la stocke dans la variable $Role.

La deuxième commande affiche le contenu de $Role.

La troisième commande affiche les classes de $Role.

Paramètres

-ComputerName

Spécifie le nom de l’ordinateur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié dans le paramètre Credential doit avoir des droits d’accès à l’ordinateur spécifié.

Type:System.String[]
Position:Named
Valeur par défaut:Localhost
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Spécifie les informations d’identification que cette applet de commande utilise pour se connecter au serveur sur lequel le service System Center Data Access s’exécute. Le compte d’utilisateur spécifié doit avoir des droits d’accès à ce serveur.

Type:System.Management.Automation.PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

Spécifie le nom d’affichage du rôle d’utilisateur à récupérer. Vous pouvez spécifier une expression régulière.

Type:System.String[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Id

Spécifie l’ID du rôle d’utilisateur à récupérer.

Type:System.Guid[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom du rôle d’utilisateur à récupérer. Vous pouvez spécifier une expression régulière.

Type:System.String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SCSession

Spécifie un objet qui représente une session sur un serveur d’administration Service Manager.

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.String

Vous pouvez diriger un nom vers le paramètre DisplayName .

System.Guid

Vous pouvez diriger un GUID vers le paramètre ID.

Sorties

Microsoft.EnterpriseManagement.ServiceManager.Sdk.UserRoles.Role

L’objet UserRole fournit les informations sur les rôles d’utilisateur Service Manager. Cet objet peut être utilisé conjointement avec l’applet de commande Update-SCSMUserRole pour ajouter un utilisateur à un rôle d’utilisateur.