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 prend 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 prend 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:
Indique que cette applet de commande 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 elle est utilisée 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. Pour plus d'informations, voir about_Remote_Requirements.
Pour plus d’informations sur les travaux en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.
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.
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.
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.
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.
Spécifie les paramètres régionaux préférés pour les objets WMI. Le paramètre de paramètres régionaux est spécifié dans un tableau au format MS_<LCID> dans l’ordre préféré.
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.
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.
Entrées
None
Cette applet de commande n’accepte pas d’entrée.
Sorties
None
Cette applet de commande ne génère pas de sortie.
Notes
Windows PowerShell inclut les alias suivants pour Set-WmiInstance:
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner des problèmes et des demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
