New-CMTSStepRunCommandLine
Cree un paso Ejecutar línea de comandos, que puede agregar a una secuencia de tareas.
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
Este cmdlet crea un nuevo objeto de paso Ejecutar línea de comandos. A continuación, use el cmdlet Add-CMTaskSequenceStep para agregar el paso a una secuencia de tareas. Para obtener más información sobre este paso, vea About task sequence steps: Run Command Line.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1
En este ejemplo se crea primero un objeto para el paso Ejecutar línea de comandos. Especifica la línea de comandos y un paquete que se va a usar.
A continuación, obtiene un objeto de secuencia de tareas y agrega este nuevo paso a la secuencia de tareas en el índice 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
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLine
Especifique la línea de comandos que se ejecuta la secuencia de tareas. Incluir extensiones de nombre de archivo, por ejemplo, .exe
. Incluya todos los archivos de configuración necesarios y las opciones de línea de comandos.
Por ejemplo: 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
Especifique un objeto de condición que se usará con este paso. Para obtener este objeto, use uno de los cmdlets de condición de secuencia de tareas. Por ejemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Agregue este parámetro para habilitar la opción de paso Continuar con el error. Al habilitar esta opción, si se produce un error en el paso, la secuencia de tareas continúa.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción opcional para este paso de secuencia de tareas.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Agregue este parámetro para deshabilitar este paso de secuencia de tareas.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWow64Redirection
De forma predeterminada, los sistemas operativos de 64 bits usan el redirector del sistema de archivos WOW64 para ejecutar líneas de comandos. Este comportamiento es buscar correctamente versiones de 32 bits de archivos ejecutables y bibliotecas del sistema operativo. Agregue este parámetro para deshabilitar el uso del redirector del sistema de archivos WOW64. Windows ejecuta el comando con versiones nativas de 64 bits de archivos ejecutables y bibliotecas del sistema operativo. Esta opción no tiene ningún efecto al ejecutarse en un sistema operativo de 32 bits.
Type: | SwitchParameter |
Aliases: | DisableRedirectionFor64BitFileSystem |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre para este paso para identificarlo en la secuencia de tareas.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputVariableName
Especifique el nombre de una variable de secuencia de tareas personalizada. Al usar este parámetro, el paso guarda los últimos 1000 caracteres del resultado del comando en la variable.
Type: | String |
Aliases: | Output, OutputVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
Cuando especifique archivos o programas en la línea de comandos que aún no existen **** en el equipo de destino, use este parámetro para especificar el identificador del paquete para un paquete que tenga los archivos necesarios. El paquete no requiere un programa. Si los archivos especificados existen en el equipo de destino, esta opción no es necesaria.
Este valor es un identificador de paquete estándar, por ejemplo XYZ00821
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Agregue este parámetro para ejecutar la línea de comandos como una cuenta Windows usuario y no como la cuenta del sistema local. A continuación, use los parámetros UserName y UserPassword.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessCode
Especifique una matriz de valores enteros como códigos de salida del comando que el paso debe evaluar como correcto.
Type: | Int32[] |
Aliases: | SuccessCodes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
Especifique un valor entero que represente cuánto tiempo Configuration Manager permite que se ejecute la línea de comandos. Este valor puede ser de 1
minutos a 999
minutos. El valor predeterminado es 15
minutos.
Si escribe un valor que no permite tiempo suficiente para que el comando especificado se complete correctamente, se produce un error en este paso. La secuencia de tareas completa podría producir un error en función de las condiciones de paso o grupo. Si expira el tiempo de espera, Configuration Manager finaliza el proceso de línea de comandos.
Type: | Int32 |
Aliases: | TimeoutInMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Cuando use el parámetro RunAsUser, use este parámetro para especificar el nombre de la cuenta Windows usuario. Para especificar la contraseña de la cuenta, use el parámetro UserPassword.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Cuando use el parámetro RunAsUser, use este parámetro para especificar la contraseña de la cuenta que especifique con UserName.
Type: | SecureString |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Especifique la carpeta en la que se inicia el comando. Esta ruta de acceso puede tener hasta 127 caracteres.
Type: | String |
Aliases: | StartIn |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Ninguno
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_RunCommandLineAction server WMI class.