L’applet de commande Set-WmiInstance crée ou met à jour une instance d’une classe WMI (Windows Management Instrumentation) existante.
L’instance créée ou mise à jour est écrite dans le référentiel WMI.
Les nouvelles applets de commande CIM, introduites par Windows PowerShell 3.0, effectuent les mêmes tâches que les applets de commande WMI.
Les applets de commande CIM sont conformes aux normes WS-Management (WSMan) et à la norme CIM (Common Information Model).
Cela permet aux applets de commande d’utiliser les mêmes techniques pour gérer les ordinateurs Windows et ceux qui exécutent d’autres systèmes d’exploitation.
Au lieu d’utiliser , envisagez d’utiliser les applets de commande Set-CimInstance ou New-CimInstance.
Exemples
Exemple 1 : Définir le niveau de journalisation WMI
Cette commande définit le niveau de journalisation WMI sur 2.
La commande transmet la propriété à définir et la valeur, ensemble considérée comme une paire valeur, dans le paramètre d’argument.
Le paramètre accepte une table de hachage définie par la construction @{property = value}.
Les informations de classe retournées reflètent la nouvelle valeur.
Exemple 2 : Créer une variable d’environnement et sa valeur
Cette commande crée la variable d’environnement testvar qui a la valeur testvalue.
Pour ce faire, créez une instance de la classe WMI Win32_Environment.
Cette opération nécessite des informations d’identification appropriées et que vous devrez peut-être redémarrer Windows PowerShell pour voir la nouvelle variable d’environnement.
Exemple 3 : Définir le niveau de journalisation WMI pour plusieurs ordinateurs distants
Cette commande définit le niveau de journalisation WMI sur 2.
La commande transmet la propriété à définir et la valeur, ensemble considérée comme une paire valeur, dans le paramètre d’argument.
Le paramètre accepte une table de hachage définie par la construction @{property = value}.
Les informations de classe retournées reflètent la nouvelle valeur.
Paramètres
-Arguments
Spécifie le nom de la propriété à modifier et la nouvelle valeur de cette propriété.
Le nom et la valeur doivent être une paire nom-valeur.
La paire nom-valeur est transmise sur la ligne de commande en tant que table de hachage.
Par exemple:
@{Setting1=1; Setting2=5; Setting3="test"}
Propriétés du paramètre
Type:
Hashtable
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
Args, Propriété
Jeux de paramètres
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
object
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-AsJob
Indique que ce cmdket s’exécute en tant que travail en arrière-plan.
Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.
Lorsque vous spécifiez le paramètre AsJob, la commande retourne un objet qui représente le travail en arrière-plan, puis affiche l’invite de commandes.
Vous pouvez continuer à travailler dans la session pendant la fin du travail.
Si set-WmiInstance est utilisé pour un ordinateur distant, le travail est créé sur l’ordinateur local et les résultats des ordinateurs distants sont automatiquement retournés à l’ordinateur local.
Pour gérer le travail, utilisez les applets de commande qui contiennent les travail nom (les applets de commande job).
Pour obtenir les résultats du travail, utilisez l’applet de commande Receive-Job.
Pour utiliser ce paramètre avec les ordinateurs distants, les ordinateurs locaux et distants doivent être configurés pour la communication à distance.
En outre, vous devez démarrer Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur dans Windows Vista et versions ultérieures du système d’exploitation Windows.
Pour plus d’informations, consultez about_Remote_Requirements.
Pour plus d’informations sur les travaux en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.
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
-Authentication
Spécifie le niveau d’authentification qui doit être utilisé avec la connexion WMI.
Les valeurs acceptables pour ce paramètre sont les suivantes :
Spécifie l’autorité à utiliser pour authentifier la connexion WMI.
Vous pouvez spécifier l’authentification NTLM ou Kerberos standard.
Pour utiliser NTLM, définissez le paramètre d’autorité sur ntlmdomain :<DomainName>, où <DomainName> identifie un nom de domaine NTLM valide.
Pour utiliser Kerberos, spécifiez kerberos :<DomainName>\<ServerName>.
Vous ne pouvez pas inclure le paramètre d’autorité lorsque vous vous connectez à l’ordinateur local.
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
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
WQLQuery
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
query
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
list
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Class
Spécifie le nom d’une classe WMI.
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
class
Position:
0
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ComputerName
Spécifie le nom de l’ordinateur sur lequel s’exécute cette applet de commande.
La valeur par défaut est l’ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d’un ou plusieurs ordinateurs.
Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, un point (.) ou localhost.
Ce paramètre ne s’appuie pas sur la communication à distance Windows PowerShell.
Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
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
Alias:
Cn
Jeux de paramètres
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
WQLQuery
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
query
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
list
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 un compte d’utilisateur autorisé à effectuer cette action.
La valeur par défaut est l’utilisateur actuel.
Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential, tel qu’un objet généré par l’applet de commande Get-Credential.
Si vous tapez un nom d’utilisateur, cette applet de commande demande un mot de passe.
Ce paramètre n’est pas pris en charge par les fournisseurs installés avec le paramètre n’est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
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
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
WQLQuery
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
query
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
list
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-EnableAllPrivileges
Indique que cette applet de commande active toutes les autorisations de l’utilisateur actuel avant la commande qu’elle effectue l’appel WMI.
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
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
WQLQuery
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
query
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
list
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Impersonation
Spécifie le niveau d’emprunt d’identité à utiliser.
Les valeurs acceptables pour ce paramètre sont les suivantes :
0 : valeur par défaut.
Lit le Registre local pour le niveau d’emprunt d’identité par défaut, qui est généralement défini sur 3 : Emprunt d’identité.
1 : Anonyme.
Masque les informations d’identification de l’appelant.
2 : Identifier.
Permet aux objets d’interroger les informations d’identification de l’appelant.
3 : Emprunt d’identité.
Permet aux objets d’utiliser les informations d’identification de l’appelant.
4 : Délégué.
Permet aux objets d’autoriser d’autres objets à utiliser les informations d’identification de l’appelant.
Spécifie un objet ManagementObject à utiliser comme entrée.
Lorsque ce paramètre est utilisé, tous les autres paramètres, à l’exception des arguments , sont ignorés.
Propriétés du paramètre
Type:
ManagementObject
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
object
Position:
Named
Obligatoire:
True
Valeur du pipeline:
True
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Locale
Spécifie les paramètres régionaux préférés pour les objets WMI.
Le paramètre Paramètres régionaux est spécifié dans un tableau au format< LCID MS_>dans l’ordre préféré.
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
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
WQLQuery
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
query
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
list
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Namespace
Spécifie l’espace de noms du référentiel WMI où se trouve la classe WMI référencée lorsqu’elle est utilisée avec le paramètre classe .
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
Alias:
NS
Jeux de paramètres
class
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
path
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
WQLQuery
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
query
Position:
Named
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
list
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 un chemin d’accès d’objet WMI de l’instance que vous souhaitez créer ou mettre à jour.
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
path
Position:
Named
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-PutType
Indique s’il faut créer ou mettre à jour l’instance WMI.
Les valeurs acceptables pour ce paramètre sont les suivantes :
Mise à jour uniquement.
Met à jour une instance WMI existante.
CreateOnly.
Crée une instance WMI.
Mettre à jourOuCréer.
Met à jour l’instance WMI s’il existe ou crée une nouvelle instance si une instance n’existe pas.
Propriétés du paramètre
Type:
PutType
Valeur par défaut:
None
Valeurs acceptées:
None, UpdateOnly, CreateOnly, UpdateOrCreate
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
-ThrottleLimit
Spécifie le nombre maximal de connexions simultanées qui peuvent être établies pour exécuter cette commande.
Ce paramètre est utilisé avec le paramètre AsJob.
La limite de limitation s’applique uniquement à la commande actuelle, et non à la session ou à l’ordinateur.
Propriétés du paramètre
Type:
Int32
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
-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.