New-CMTSStepRunCommandLine
Créez une étape Exécuter la ligne de commande , que vous pouvez ajouter à une séquence de tâches.
Syntaxe
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette applet de commande crée un objet d’étape Exécuter la ligne de commande . Utilisez ensuite l’applet de commande Add-CMTaskSequenceStep pour ajouter l’étape à une séquence de tâches. Pour plus d’informations sur cette étape, consultez À propos des étapes de séquence de tâches : Exécuter la ligne de commande.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>
. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1
Cet exemple crée d’abord un objet pour l’étape Exécuter la ligne de commande . Il spécifie la ligne de commande et un package à utiliser.
Il obtient ensuite un objet de séquence de tâches et ajoute cette nouvelle étape à la séquence de tâches à l’index 11.
$step = New-CMTSStepRunCommandLine -Name "Run Command Line" -CommandLine "cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat" -PackageId "XYZ00821"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Paramètres
-CommandLine
Spécifiez la ligne de commande exécutée par la séquence de tâches. Incluez les extensions de nom de fichier, par exemple . .exe
Incluez tous les fichiers de paramètres et options de ligne de commande requis.
Par exemple : cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Condition
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.
Type: | IResultObject[] |
Alias: | Conditions |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ContinueOnError
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.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Description
Spécifiez une description facultative pour cette étape de séquence de tâches.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Disable
Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.
Type: | SwitchParameter |
Alias: | DisableThisStep |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DisableWildcardHandling
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.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DisableWow64Redirection
Par défaut, les systèmes d’exploitation 64 bits utilisent le redirecteur du système de fichiers WOW64 pour exécuter les lignes de commande. Ce comportement consiste à rechercher correctement les versions 32 bits des exécutables et bibliothèques du système d’exploitation. Ajoutez ce paramètre pour désactiver l’utilisation du redirecteur du système de fichiers WOW64. Windows exécute la commande à l’aide de versions natives 64 bits d’exécutables et de bibliothèques de système d’exploitation. Cette option n’a aucun effet lors de l’exécution sur un système d’exploitation 32 bits.
Type: | SwitchParameter |
Alias: | DisableRedirectionFor64BitFileSystem |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ForceWildcardHandling
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.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Name
Spécifiez un nom pour cette étape afin de l’identifier dans la séquence de tâches.
Type: | String |
Alias: | StepName |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-OutputVariableName
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.
Type: | String |
Alias: | Output, OutputVariable |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PackageId
Lorsque vous spécifiez des fichiers ou des programmes sur la ligne de commande qui n’existent pas encore sur l’ordinateur de destination, utilisez ce paramètre pour spécifier l’ID de package d’un package contenant les fichiers nécessaires. Le package ne nécessite pas de programme. Si les fichiers spécifiés existent sur l’ordinateur de destination, cette option n’est pas obligatoire.
Cette valeur est un ID de package standard, par exemple XYZ00821
.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-RunAsUser
Ajoutez ce paramètre pour exécuter la ligne de commande en tant que compte d’utilisateur Windows et non comme compte système local. Utilisez ensuite les paramètres UserName et UserPassword .
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SuccessCode
Spécifiez un tableau de valeurs entières comme codes de sortie à partir de la commande que l’étape doit évaluer comme une réussite.
Type: | Int32[] |
Alias: | SuccessCodes |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Timeout
Spécifiez une valeur entière qui représente la durée pendant laquelle Configuration Manager autorise l’exécution de la ligne de commande. 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 la commande spécifiée s’exécute 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 de ligne de commande.
Type: | Int32 |
Alias: | TimeoutInMinutes |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UserName
Lorsque vous utilisez le paramètre RunAsUser , utilisez ce paramètre pour spécifier le nom du compte d’utilisateur Windows. Pour spécifier le mot de passe du compte, utilisez le paramètre UserPassword .
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UserPassword
Lorsque vous utilisez le paramètre RunAsUser , utilisez ce paramètre pour spécifier le mot de passe du compte que vous spécifiez avec UserName.
Type: | SecureString |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-WorkingDirectory
Spécifiez le dossier dans lequel la commande démarre. Ce chemin peut comporter jusqu’à 127 caractères.
Type: | String |
Alias: | StartIn |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
None
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_RunCommandLineAction classe WMI du serveur.