Partager via

Update-SCOMRunAsAccount

Module:
OperationsManager Module

Met à jour les informations d’identification d’un compte d’identification Operations Manager.

Syntaxe

WindowsAccount 

Update-SCOMRunAsAccount
    [-WindowsAccount] <WindowsCredentialSecureData>
    [-RunAsCredential] <PSCredential>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BasicAccount 

Update-SCOMRunAsAccount
    [-BasicAccount] <BasicCredentialSecureData>
    [-RunAsCredential] <PSCredential>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SimpleAccount 

Update-SCOMRunAsAccount
    [-SimpleAccount] <SimpleCredentialSecureData>
    [-RunAsCredential] <PSCredential>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DigestAccount 

Update-SCOMRunAsAccount
    [-DigestAccount] <DigestCredentialSecureData>
    [-RunAsCredential] <PSCredential>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ActionAccount 

Update-SCOMRunAsAccount
    [-ActionAccount] <ActionAccountSecureData>
    [-RunAsCredential] <PSCredential>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CommunityStringAccount 

Update-SCOMRunAsAccount
    [-CommunityStringAccount] <CommunityStringSecureData>
    [-CommunityString] <SecureString>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BinaryAccount 

Update-SCOMRunAsAccount
    [-BinaryAccount] <GenericSecureData>
    [-Path] <String>
    [-AccountType <String>]
    [-PassThru]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

La cmdlet Update-SCOMRunAsAccount met à jour les informations d’identification d’un compte d’identification System Center - Operations Manager. Un compte d’identification permet aux utilisateurs de spécifier les autorisations nécessaires pour une utilisation avec des règles, des tâches, des analyses et des découvertes ciblées sur des ordinateurs spécifiques en fonction des besoins.

Cette applet de commande ne prend pas en charge les comptes SCX (multiplateforme) ou les comptes SNMPv3 (Simple Network Management Protocol version 3). À la place, Get-SCOMRunAsAccount pour mettre à jour les comptes SCX.

Exemples

Exemple 1 : Mettre à jour un compte d’identification Windows

PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\>$WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

Cet exemple met à jour un compte d’identification Windows.

La première commande obtient l’objet de compte d’identification nommé Domain Admin et stocke l’objet dans la variable $WindowsAccount.

La deuxième commande transmet le compte d’identification stocké dans la variable $WindowsAccount à l’applet de commande Update-SCOMRunAsAccount à l’aide de l’opérateur de pipeline. Cette applet de commande met à jour les informations d’identification du compte avec le nom d’utilisateur et le mot de passe que l’utilisateur fournit en répondant à l’invite de l'applet de commande Get-Credential.

Exemple 2 : Mettre à jour un compte d’identification d’action

PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\>$Password = Read-Host -AsSecureString
PS C:\>$NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\>Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

Cet exemple met à jour les informations d’identification d’un compte d’identification d’action.

La première commande crée une chaîne qui contient un nom de compte d’action et stocke la chaîne dans la variable $UserName.

La deuxième commande invite l’utilisateur à entrer une chaîne qui représente le mot de passe. Il stocke ensuite l’entrée utilisateur sous forme de chaîne sécurisée dans la variable $Password.

La troisième commande crée un objet PSCredential à l’aide du nom stocké dans la variable $UserName et du mot de passe stocké dans $Password. Il stocke ensuite l’objet PSCredential dans la variable $NewCred.

La dernière commande obtient le compte d’action nommé compte d’action SCOM. Il utilise ensuite l’opérateur de pipeline pour transmettre le compte à l’applet de commande Update-SCOMRunAsAccount , qui met à jour le compte avec les informations d’identification stockées dans la variable $NewCred.

Exemple 3 : Mettre à jour un compte de chaîne de communauté

PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

Cette commande met à jour les informations d’identification d’un compte d’identification qui utilise l’authentification de chaîne de communauté pour SNMP version 2. Il obtient le compte de chaîne de communauté nommé MyCommunityStringAccount et utilise l’opérateur de pipeline pour transmettre le compte à l’applet de commande Update-SCOMRunAsAccount. Cette applet de commande met à jour la chaîne de la communauté avec la valeur que l’utilisateur entre en réponse aux invites de l’applet de commande en lecture-hôte. Pour plus d’informations, tapez Get-Help Read-Host.

Exemple 4 : Mettre à jour un compte d’authentification binaire

PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

Cet exemple obtient l’objet de compte binaire nommé MyBinaryAccount et utilise l’opérateur de pipeline pour transmettre l’objet à l’applet de commande Update-SCOMRunAsAccount. Cette applet de commande utilise le paramètre Path pour indiquer qu’il obtient les nouvelles données de compte à partir du fichier nommé data.txt.

Paramètres

-AccountType

Spécifie le type du compte d’identification. Le pipeline remplit généralement cette valeur automatiquement.

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é:True
Valeur des arguments restants:False

-ActionAccount

Spécifie un compte d’action en tant que compte d’identification.

Propriétés du paramètre

Type:ActionAccountSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ActionAccount
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-BasicAccount

Spécifie un compte d’identification qui utilise l’authentification de base.

Propriétés du paramètre

Type:BasicCredentialSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

BasicAccount
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-BinaryAccount

Spécifie un compte d’identification qui utilise l’authentification binaire.

Propriétés du paramètre

Type:GenericSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

BinaryAccount
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CommunityString

Spécifie la nouvelle chaîne de communauté pour un compte d’identification SNMP version 2 qui utilise l’authentification de chaîne de communauté.

Propriétés du paramètre

Type:SecureString
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CommunityStringAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CommunityStringAccount

Spécifie un compte d’identification SNMP version 2 qui utilise l’authentification par chaîne de communauté.

Propriétés du paramètre

Type:CommunityStringSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CommunityStringAccount
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

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

Le service System Center Data Access doit être démarré sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

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

-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

-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 retourné par l’applet de commande Get-Credential 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

-DigestAccount

Spécifie un compte d’identification qui utilise l’authentification web digest standard.

Propriétés du paramètre

Type:DigestCredentialSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DigestAccount
Position:1
Obligatoire:True
Valeur du pipeline:True
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

-Path

Spécifie le chemin d’accès à un fichier qui contient de nouvelles données d’informations d’identification pour les comptes d’identification qui utilisent l’authentification binaire.

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

BinaryAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RunAsCredential

Spécifie de nouvelles informations d’identification pour les types de comptes qui utilisent un nom d’utilisateur et un mot de passe.

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

WindowsAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
BasicAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
SimpleAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
DigestAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ActionAccount
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SCSession

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

Si ce paramètre n’est pas spécifié, 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

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

-SimpleAccount

Spécifie un compte d’identification qui utilise une authentification web simple.

Propriétés du paramètre

Type:SimpleCredentialSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SimpleAccount
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

-WindowsAccount

Spécifie un compte d’identification qui utilise l’authentification Windows.

Propriétés du paramètre

Type:WindowsCredentialSecureData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

WindowsAccount
Position:1
Obligatoire:True
Valeur du pipeline:True
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.