Set-SCOMUserRole
Configure un rôle d’utilisateur Operations Manager.
Syntaxe
FromUser
Set-SCOMUserRole
[-UserRole] <UserRole>
-User <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromAllClassScope
Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllClass]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromClassScope
Set-SCOMUserRole
[-UserRole] <UserRole>
-ClassScope <ManagementPackClass[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromAllTaskScope
Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllTask]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromTaskScope
Set-SCOMUserRole
[-UserRole] <UserRole>
-TaskScope <ManagementPackTask[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromAllGroupScope
Set-SCOMUserRole
[-UserRole] <UserRole>
[-AllGroup]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromGroupcope
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromAllClassScope
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllGroup
Indique que les autorisations accordées par un rôle d’utilisateur s’étendent à tous les groupes.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromAllGroupScope
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromAllTaskScope
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | ManagementPackClass[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromClassScope
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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, @().
Propriétés du paramètre
| Type: | MonitoringObjectGroup[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromGroupcope
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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, @().
Propriétés du paramètre
| Type: | ManagementPackTask[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromTaskScope
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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, @().
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromUser
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UserRole
Spécifie un objet de rôle d’utilisateur. Pour obtenir un objet UserRole, nous l’applet de commande Get-SCOMUserRole.
Propriétés du paramètre
| Type: | UserRole |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.