New-CMTSStepRunCommandLine
Créez une étape de ligne de commande d’exécuter, que vous pouvez ajouter à une séquence de tâches.
Syntax
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 cmdlet crée un objet d’étape de ligne de commande Run. Utilisez ensuite la cmdlet Add-CMTaskSequenceStep pour ajouter l’étape à une séquence de tâches. Pour plus d’informations sur cette étape, voir à propos des étapes de la séquence de tâches : Exécuter la ligne de commande.
Notes
Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\>
exemple. Pour plus d’informations, voir la mise en place.
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
- Confirmer
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
- WhatIf
Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLine
Spécifiez la ligne de commande que la séquence de tâches exécute. Inclure des extensions de nom de fichier, par exemple, .exe
. Inclure tous les fichiers de paramètres requis et les options de ligne de commande.
Par exemple : cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Spécifiez un objet condition à utiliser avec cette étape. Pour obtenir cet objet, utilisez l’une des cmdlets de condition de séquence de tâches. Par exemple, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Ajoutez ce paramètre pour activer l’option d’étape Continuer sur l’erreur. Lorsque vous activez cette option, si l’étape échoue, la séquence de tâches se poursuit.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifiez une description facultative pour cette étape de séquence de tâches.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWow64Redirection
Par défaut, les systèmes d’exploitation 64 bits utilisent le redirecteur de système de fichiers WOW64 pour exécuter des lignes de commande. Ce comportement consiste à rechercher correctement les versions 32 bits des bibliothèques et des exécutables du système d’exploitation. Ajoutez ce paramètre pour désactiver l’utilisation du redirecteur de système de fichiers WOW64. Windows exécute la commande à l’aide de versions natives 64 bits des exécutables et 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 |
Aliases: | DisableRedirectionFor64BitFileSystem |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom pour cette étape pour l’identifier dans la séquence de tâches.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | Output, OutputVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
Lorsque vous spécifiez des fichiers ou des programmes sur la ligne de commande qui n’existent pas déjà sur l’ordinateur de destination, utilisez ce paramètre pour spécifier l’ID de package d’un package qui dispose des 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 XYZ00821
exemple.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Ajoutez ce paramètre pour exécuter la ligne de commande sous la Windows d’utilisateur et non en tant que compte système local. Utilisez ensuite les paramètres UserName et UserPassword.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessCode
Spécifiez un tableau de valeurs de nombres multiples en tant que codes de sortie à partir de la commande que l’étape doit évaluer comme étant réussie.
Type: | Int32[] |
Aliases: | SuccessCodes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
Spécifiez une valeur de nombre qui représente la durée pendant combien de temps Configuration Manager autorise l’exécuter la ligne de commande. Cette valeur peut être de 1
minutes à 999
quelques 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 se termine correctement, cette étape échoue. La séquence de tâches entière 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 |
Aliases: | TimeoutInMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Lorsque vous utilisez le paramètre RunAsUser, utilisez ce paramètre pour spécifier le nom du compte Windows utilisateur. Pour spécifier le mot de passe du compte, utilisez le paramètre UserPassword.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Spécifiez le dossier dans lequel la commande démarre. Ce chemin d’accès peut prendre jusqu’à 127 caractères.
Type: | String |
Aliases: | StartIn |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Néant
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_TaskSequence_RunCommandLineAction classe WMI du serveur.