Set-SCOMRunAsProfile
Ajoute ou supprime des comptes d’identification d’un profil d’identification.
Syntaxe
Empty (Par défaut)
Set-SCOMRunAsProfile
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementPackClass
Set-SCOMRunAsProfile
[-Class] <ManagementPackClass[]>
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromInstance
Set-SCOMRunAsProfile
[-Instance] <MonitoringObject[]>
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromGroup
Set-SCOMRunAsProfile
[-Group] <MonitoringObject[]>
[-Account] <SecureData[]>
[-Profile] <ManagementPackSecureReference>
[-Action] <RunAsProfileAccountsAction>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-SCOMRunAsProfile ajoute des comptes d’identification à un profil d’identification ou en supprime un.
Exemples
Exemple 1 : Ajouter un compte d’identification à un profil d’identification en spécifiant un nom de compte
PS C:\>$Profile = Get-RunAsProfile -DisplayName "Privileged Monitoring Account"
PS C:\> $Account = Get-SCOMRunAsAccount -Name "High Privileged Account"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account
Cet exemple ajoute un compte d’identification à un profil d’identification en spécifiant un nom de compte.
La première commande récupère le profil d’identification dont le nom d’affichage est Privileged Monitoring Account et le stocke dans la variable $Profile.
La deuxième commande récupère le compte d’identification nommé Compte à privilèges élevés et le stocke dans la variable $Account.
La troisième commande ajoute le compte stocké dans la variable $Account au profil d’identification stocké dans la variable $Profile et configure le compte d’identification. Étant donné que la commande ne spécifie pas de classe, de groupe ou d’objet, elle configure le compte d’identification pour gérer tous les objets ciblés.
Exemple 2 : Ajouter un compte d’identification à un profil d’identification en spécifiant un chemin d’accès
PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group
Cet exemple ajoute un compte d’identification à un profil d’identification en spécifiant un nom de chemin d’accès.
La première commande récupère le profil d’identification nommé SQL Server Monitoring Account et le stocke dans la variable $Profile.
La deuxième commande récupère le compte d’identification nommé Contoso\SQLAuth et le stocke dans la variable $Account.
La troisième commande récupère le groupe nommé Contoso financial SQL Server et le stocke dans la variable $Group.
La quatrième commande ajoute le compte stocké dans la variable $Account au profil d’identification stocké dans la variable $Profile et configure le compte d’identification pour gérer le groupe stocké dans la variable $Group.
Exemple 3 : Ajouter un compte d’identification à un profil d’identification en spécifiant un objet
PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group
Cet exemple ajoute un compte d’identification à un profil d’identification en spécifiant un objet de compte.
La première commande obtient l’objet de profil Exécuter en tant que qui porte le nom complet Compte de surveillance SQL Server et stocke l’objet dans la variable $Profile.
La deuxième commande récupère l’objet de compte Exécuter en tant que nommé Contoso\SQLAuth et stocke l’objet dans la variable $Account.
La troisième commande obtient l’objet de groupe dont le nom complet est Contoso financial SQL Server et stocke l’objet dans la variable $Group.
La dernière commande ajoute le compte et le groupe stockés dans $Account et $Group au profil SQL Server Monitoring Account, qui est stocké dans la variable $Profile.
Paramètres
-Account
Spécifie un tableau d’objets Microsoft.EnterpriseManagement.Security.SecureData qui représentent des comptes d’identification. Pour obtenir un objet SecureData , utilisez l’applet de commande Get-SCOMRunAsAccount .
Propriétés du paramètre
| Type: | SecureData[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Action
Spécifie l’action à effectuer pour mettre à jour le profil d’identification. Les valeurs acceptables pour ce paramètre sont : Ajouter ou Supprimer.
Propriétés du paramètre
| Type: | RunAsProfileAccountsAction |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Class
Spécifie un tableau d’objets ManagementPackClass qui représentent les classes que le compte d’identification peut gérer. Spécifiez une variable qui stocke des classes ou utilisez une applet de commande telle que Get-SCOMClass qui obtient des classes.
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
FromManagementPackClass
| Position: | 1 |
| 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 |
-Group
Spécifie un tableau d’objets de surveillance qui représentent les groupes que le compte d’identification peut gérer. Spécifiez une variable qui stocke des groupes ou utilisez une applet de commande telle que Get-SCOMGroup qui obtient des groupes.
Propriétés du paramètre
| Type: | MonitoringObject[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromGroup
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Instance
Spécifie un tableau d’objets de surveillance qui représentent les instances de classe que le compte d’identification peut gérer. Spécifiez une variable qui stocke les instances de classe ou utilisez une applet de commande telle que Get-SCOMClassInstance qui obtient les instances de classe. Ce paramètre accepte également les objets de groupe. Pour obtenir un objet de groupe, utilisez l’applet de commande Get-SCOMGroup .
Propriétés du paramètre
| Type: | MonitoringObject[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromInstance
| Position: | 1 |
| 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 |
-Profile
Spécifie le profil d’identification à mettre à jour. Spécifiez une variable qui stocke un profil d’identification ou utilisez une applet de commande telle que Get-SCOMRunAsProfile qui obtient un profil.
Propriétés du paramètre
| Type: | ManagementPackSecureReference |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| 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 ne s’exécute pas.
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.