Get-SCOMUserRole
Obtient les rôles d’utilisateur.
Syntaxe
Empty (Par défaut)
Get-SCOMUserRole
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromUserRoleDisplayName
Get-SCOMUserRole
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromUserRoleId
Get-SCOMUserRole
-Id <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromUserRoleName
Get-SCOMUserRole
-Name <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
L’applet de commande Get-SCOMUserRole obtient les rôles d’utilisateur. Un rôle d’utilisateur combine deux éléments :
- Profil. Définit l’ensemble des 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.
Exemples
Exemple 1 : Obtenir des informations sur le rôle d’utilisateur pour un rôle
PS C:\>Get-SCOMUserRole -Name "OperationsManagerReadOnlyOperators"
Cette commande récupère les informations relatives au rôle d’utilisateur nommé OperationsManagerReadOnlyOperators.
Paramètres
-ComputerName
Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec les 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 actuelle du groupe d’administration.
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
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute.
Spécifiez un objet PSCredential , tel que celui renvoyé par l’applet de commande Get-Credential , pour ce paramètre.
Pour plus d’informations sur les objets d’informations d’identification, 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
| Type: | PSCredential |
| 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 |
-DisplayName
Spécifie un tableau qui contient les noms d’affichage des objets de rôle utilisateur. L’applet de commande prend chaque chaîne du tableau et recherche des correspondances parmi les noms d’affichage des objets de rôle d’utilisateur avec lesquels cette applet de commande fonctionne. Les valeurs de ce paramètre varient en fonction des packs d’administration localisés importés dans le groupe d’administration et des paramètres régionaux de l’utilisateur qui exécute Windows PowerShell.
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
FromUserRoleDisplayName
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Id
Spécifie un tableau d’ID pour les objets de rôle d’utilisateur. L’applet de commande prend chaque identificateur global unique (GUID) du tableau et recherche des correspondances avec les propriétés ID des objets de rôle d’utilisateur que l’applet de commande obtient.
Propriétés du paramètre
| Type: | Guid[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromUserRoleId
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie un tableau qui contient les noms des objets de rôle utilisateur. L’applet de commande prend chaque chaîne du tableau et recherche des correspondances avec les propriétés Name des objets de rôle d’utilisateur qu’elle obtient.
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
FromUserRoleName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SCSession
Spécifie un tableau d’objets Connection . Pour obtenir des objets Connection , spécifiez l’applet de commande Get-SCOMManagementGroupConnection .
Si vous ne spécifiez pas de valeur pour ce paramètre, l’applet de commande utilise la connexion persistante active à un groupe d’administration.
Utilisez le paramètre SCSession pour spécifier une autre connexion persistante.
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
| Type: | Connection[] |
| 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 |
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.