Add-SCOMUserRole

Syntaxe

Operator (Par défaut)

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-Operator]
    [-TaskScope <ManagementPackTask[]>]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ReadOnlyOperator

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-ReadOnlyOperator]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Author

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-Author]
    [-ClassScope <ManagementPackClass[]>]
    [-TaskScope <ManagementPackTask[]>]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AdvancedOperator

Add-SCOMUserRole
    [-Name] <String>
    [[-DisplayName] <String>]
    [[-Description] <String>]
    [[-Users] <String[]>]
    [-AdvancedOperator]
    [-TaskScope <ManagementPackTask[]>]
    [-GroupScope <MonitoringObjectGroup[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemples

Exemple 1 : Ajouter un nouveau rôle d’utilisateur Opérateur lecture seule

PS C:\>Add-SCOMUserRole -Name 'Script Role' -ReadOnlyOperator

Exemple 2 : Ajouter un nouveau rôle d’utilisateur en spécifiant des noms d’utilisateur, des tâches et des groupes

PS C:\>$ApprovedTasks = Get-SCOMTask -Name '*SQL*'
PS C:\> $ApprovedGroups = Get-SCOMGroup -DisplayName '*SQL*'
PS C:\> Add-SCOMUserRole -Name 'SQL Operator' -Operator -GroupScope $ApprovedGroups -TaskScope $ApprovedTasks -User 'Contoso\Katarina','Contoso\Cesar'

Paramètres

-AdvancedOperator

Indique que le nouveau rôle est un opérateur avancé. Ce rôle accorde aux membres la possibilité de remplacer la configuration des règles et de surveiller des cibles spécifiques ou des groupes de cibles dans l’étendue configurée. Le rôle Opérateur avancé accorde également toutes les autorisations accordées par l’opérateur et les profils d’opérateur Read-Only.

Propriétés du paramètre

Jeux de paramètres

-Author

Indique que le nouveau rôle est un auteur. Ce rôle accorde aux membres la possibilité de créer, de modifier et de supprimer la configuration de surveillance qui inclut des tâches, des règles, des analyses et des vues, dans l’étendue configurée. Pour plus de commodité, un rôle Auteur peut avoir des autorisations pour des groupes spécifiques. Le rôle Auteur accorde également toutes les autorisations dans les rôles Opérateur, Opérateur et Read-Only Opérateur avancés.

Propriétés du paramètre

Jeux de paramètres

-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 .

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

Propriétés du paramètre

Jeux de paramètres

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

L’ordinateur doit exécuter le service System Center Data Access.

Si vous ne spécifiez pas ce paramètre, la valeur par défaut est l’ordinateur de la connexion de groupe d’administration actuelle.

Propriétés du paramètre

Jeux de paramètres

-Confirm

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

Propriétés du paramètre

Jeux de paramètres

-Credential

Spécifie un objet PSCredential pour la connexion de groupe d’administration. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential . Pour plus d’informations, tapez Get-Help Get-Credential.

Si vous spécifiez un ordinateur dans le paramètre ComputerName, utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

Propriétés du paramètre

Jeux de paramètres

-Description

Spécifie une description du rôle d’utilisateur. Si vous ne spécifiez pas de valeur pour ce paramètre, l’applet de commande utilise la valeur du paramètre DisplayName.

Propriétés du paramètre

Jeux de paramètres

-DisplayName

Spécifie le nom complet du rôle d’utilisateur. Si ce paramètre n’apparaît pas, la valeur par défaut est la valeur dans le paramètre Name.

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

-Name

Spécifie le nom du rôle d’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-Operator

Indique que le nouveau rôle est un opérateur. Ce rôle permet aux membres d’interagir avec les alertes, d’exécuter des tâches et d’accéder aux vues en fonction de leur étendue configurée. Le rôle Opérateur accorde également toutes les autorisations accordées par le profil opérateur Read-Only.

Propriétés du paramètre

Jeux de paramètres

-ReadOnlyOperator

Indique que le nouveau rôle est un opérateur Read-Only. Ce rôle accorde aux membres la possibilité d’afficher les alertes et d’accéder aux vues en fonction de leur étendue configurée.

Propriétés du paramètre

Jeux de paramètres

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir objets Connection, spécifiez l’applet de commande Get-SCOMManagementGroupConnection .

Si ce paramètre n’apparaît pas, l’applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez Get-Help about_OpsMgr_Connections.

Propriétés du paramètre

Jeux de paramètres

-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. Pour obtenir un objet ManagementPackTask, utilisez l’applet de commande ManagementPack.GetTask. Si ce paramètre n’apparaît pas, 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

Jeux de paramètres

-Users

Spécifie un tableau qui contient les noms des utilisateurs qui font partie du rôle d’utilisateur.

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

CommonParameters

Liens associés

• Get-SCOMUserRole
• Set-SCOMUserRole