New-CMTSStepRunPowerShellScript

Spécifiez un objet de condition à utiliser avec cette étape. Pour obtenir cet objet, utilisez l’une des applets de commande de condition de séquence de tâches. Par exemple, Get-CMTSStepConditionVariable.

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Ajoutez ce paramètre pour activer l’option d’étape Continuer en cas d’erreur. Lorsque vous activez cette option, si l’étape échoue, la séquence de tâches continue.

Spécifiez une description facultative pour cette étape de séquence de tâches.

Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Spécifiez la stratégie d’exécution PowerShell pour les scripts que vous autorisez à exécuter sur l’ordinateur. Choisissez l’une des stratégies suivantes :

• AllSigned: exécutez uniquement les scripts signés par un éditeur approuvé.

• Undefined: ne définissez aucune stratégie d’exécution.

• Bypass: chargez tous les fichiers de configuration et exécutez tous les scripts. Si vous téléchargez un script non signé à partir d’Internet, PowerShell ne demande pas d’autorisation avant d’exécuter le script.

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Spécifiez un nom pour cette étape afin de l’identifier dans la séquence de tâches.

Spécifiez le nom d’une variable de séquence de tâches personnalisée. Lorsque vous utilisez ce paramètre, l’étape enregistre les 1 000 derniers caractères de la sortie de commande dans la variable.

Spécifiez l’ID de package pour le package qui contient le script PowerShell. Le package ne nécessite pas de programme. Un package peut contenir plusieurs scripts.

Cette valeur est un ID de package standard, par exemple XYZ00821.

Utilisez ensuite le paramètre ScriptName pour spécifier le nom du script.

Spécifiez les paramètres passés au script PowerShell. Ces paramètres sont identiques aux paramètres de script PowerShell sur la ligne de commande. Fournissez les paramètres consommés par le script, et non pour la ligne de commande PowerShell.

L’exemple suivant contient des paramètres valides :

-MyParameter1 MyValue1 -MyParameter2 MyValue2

L’exemple suivant contient des paramètres non valides . Les deux premiers éléments sont des paramètres de ligne de commande PowerShell (NoLogo et ExecutionPolicy). Le script n’utilise pas ces paramètres.

-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2

Si une valeur de paramètre inclut un caractère spécial ou un espace, utilisez des guillemets simples (') autour de la valeur. L’utilisation de guillemets doubles (") peut entraîner le traitement incorrect du paramètre par l’étape de séquence de tâches.

Par exemple : -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'

Vous pouvez également définir ce paramètre sur une variable de séquence de tâches. Par exemple, si vous spécifiez %MyScriptVariable%, lorsque la séquence de tâches exécute le script, elle ajoute la valeur de cette variable personnalisée à la ligne de commande PowerShell.

Spécifiez le nom du script à exécuter. Ce script se trouve dans le package spécifié par le paramètre PackageId .

Au lieu d’utiliser les paramètres PackageId et ScriptName , utilisez ce paramètre pour spécifier directement les commandes de script. Cette valeur de chaîne est les commandes PowerShell exécutées par cette étape.

Vous pouvez lire le contenu d’un fichier de script existant dans une variable de chaîne, puis utiliser cette variable pour ce paramètre. Par exemple :

$script = [IO.File]::ReadAllText( "C:\temp\script.ps1" )

Spécifiez un tableau de valeurs entières comme codes de sortie à partir du script que l’étape doit évaluer comme une réussite.

Spécifiez une valeur entière qui représente la durée pendant laquelle Configuration Manager autorise l’exécution du script. Cette valeur peut être comprise entre la 1 minute et les 999 minutes. La valeur par défaut est 15 minutes.

Si vous entrez une valeur qui ne laisse pas suffisamment de temps pour que le script spécifié se termine correctement, cette étape échoue. L’ensemble de la séquence de tâches peut échouer en fonction des conditions d’étape ou de groupe. Si le délai d’expiration expire, Configuration Manager met fin au processus PowerShell.

Utilisez ce paramètre pour exécuter le script en tant que compte d’utilisateur Windows et non comme compte système local. Spécifiez le nom du compte d’utilisateur Windows. Pour spécifier le mot de passe du compte, utilisez le paramètre UserPassword .

Utilisez ce paramètre pour spécifier le mot de passe du compte que vous spécifiez avec UserName.

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Spécifiez le dossier dans lequel la commande démarre. Ce chemin peut comporter jusqu’à 127 caractères.