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.