Set-SCOMUserRole

Module:

OperationsManager

Configure un rôle d’utilisateur Operations Manager.

Syntaxe

Set-SCOMUserRole
   [-UserRole] <UserRole>
   -User <String[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllClass]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMUserRole
   [-UserRole] <UserRole>
   -ClassScope <ManagementPackClass[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllTask]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMUserRole
   [-UserRole] <UserRole>
   -TaskScope <ManagementPackTask[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMUserRole
   [-UserRole] <UserRole>
   [-AllGroup]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMUserRole
   [-UserRole] <UserRole>
   -GroupScope <MonitoringObjectGroup[]>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-SCOMUserRole configure un rôle d’utilisateur System Center - Operations Manager. Un rôle d’utilisateur contient deux fonctionnalités :

• Profil. Définit la collection d’opérations auxquelles le rôle d’utilisateur a accès.
• Portée. Définit les limites des opérations de profil ; par exemple, les tâches et les groupes.

Vous pouvez utiliser cette applet de commande pour mettre à jour la liste des utilisateurs ou l’étendue du rôle d’utilisateur.

Exemples

Exemple 1 : Accorder un accès au rôle d’utilisateur à toutes les tâches

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso Operators"
PS C:\> $Role | Set-SCOMUserRole -AllTask -PassThru | Set-SCOMUserRole -AllGroup

Cet exemple montre comment mettre à jour un rôle d’utilisateur pour lui accorder l’accès à toutes les tâches.

La première commande obtient l’objet de rôle d’utilisateur nommé Opérateurs Contoso et stocke l’objet dans la variable $Role.

La deuxième commande utilise l’opérateur de pipeline pour transmettre le rôle d’utilisateur stocké dans la variable $Role à l’applet de commande Set-SCOMUserRole. Cette applet de commande accorde l’accès au rôle d’utilisateur à toutes les tâches et retourne l’objet de rôle d’utilisateur mis à jour. La commande transmet ensuite l’objet mis à jour à Set-SCOMUserRole à l’aide de l’opérateur de pipeline, qui approuve le rôle pour tous les groupes.

Exemple 2 : Accorder à un rôle d’utilisateur l’accès à des tâches spécifiques

PS C:\>$Role = Get-SCOMUserRole -Name "Constoso SQL Operators"
PS C:\> $NewTaskList = Get-SCOMTask -Name "*SQL*"
PS C:\> $Role | Set-SCOMUserRole -TaskScope $NewTaskList

Cet exemple montre comment mettre à jour un rôle d’utilisateur pour lui accorder l’accès à des tâches spécifiques.

La première commande obtient l’objet de rôle d’utilisateur nommé Contoso SQL Operators et stocke l’objet dans la variable $Role.

La deuxième commande obtient tous les objets de tâche avec SQL dans leurs noms et stocke les objets dans la variable $NewTaskList.

La dernière commande utilise l’opérateur de pipeline pour transmettre le rôle d’utilisateur stocké dans la variable $Role à Set-SCOMUserRole, qui réinitialise la collection de tâches approuvées à la liste stockée dans la variable $NewTaskList.

Exemple 3 : Ajouter un utilisateur à un rôle d’utilisateur

PS C:\>$Role = Get-SCOMUserRole -Name "Contoso Read-Only Operators"
PS C:\> $Role | Set-SCOMUserRole -User ($Role.Users + "Contoso\Cesar")

Cet exemple montre comment ajouter un utilisateur à un rôle d’utilisateur.

La première commande obtient l’objet de rôle d’utilisateur nommé Contoso Read-Only Opérateurs et stocke l’objet dans la variable $Role.

La deuxième commande utilise l’opérateur de pipeline pour transmettre l’objet stocké dans la variable $Role à l’applet de commande Set-SCOMUserRole, qui ajoute l’utilisateur Contoso\Cesar à la liste existante d’utilisateurs pour le rôle.

Paramètres

-AllClass

Indique que les autorisations accordées par un rôle d’utilisateur Auteur s’étendent à toutes les classes.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AllGroup

Indique que les autorisations accordées par un rôle d’utilisateur s’étendent à tous les groupes.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AllTask

Indique que les autorisations accordées par un rôle d’utilisateur Auteur, Opérateur ou Opérateur avancé s’étendent à toutes les tâches.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ClassScope

Spécifie un tableau d’objets ManagementPackClass qui représentent les classes auxquelles un rôle Auteur a accès. Pour obtenir un objet ManagementPackClass, utilisez l’applet de commande Get-SCOMClass .

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-GroupScope

Spécifie un tableau d’objets MonitoringObjectGroup qui représentent les groupes auxquels un rôle d’utilisateur a accès. Pour obtenir un objet de groupe d’objets d’analyse, utilisez l’applet de commande Get-MonitoringObjectGroup .

Si vous ne spécifiez pas de valeur pour ce paramètre, le rôle a accès à tous les groupes. Pour refuser l’accès au rôle à tous les groupes, spécifiez $Null ou un tableau vide, @().

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

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

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

-TaskScope

Spécifie un tableau d’objets ManagementPackTask qui représentent les tâches auxquelles un rôle Auteur, Opérateur ou Opérateur avancé a accès.

Si vous ne spécifiez pas de valeur pour ce paramètre, le rôle a accès à toutes les tâches. Pour refuser l’accès au rôle Auteur, Opérateur ou Opérateur avancé à toutes les tâches, spécifiez $Null ou un tableau vide, @().

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

-User

Spécifie un tableau de noms d’utilisateurs qui font partie de ce rôle d’utilisateur. Cette liste remplace toute liste existante d’utilisateurs. Pour effacer tous les utilisateurs d’un rôle d’utilisateur, spécifiez $Null ou un tableau vide, @().

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

-UserRole

Spécifie un objet de rôle d’utilisateur. Pour obtenir un objet UserRole, nous l’applet de commande Get-SCOMUserRole.

Type:	UserRole
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Liens associés

• Add-SCOMUserRole
• Get-SCOMUserRole
• Get-SCClass