Cree el paso Ejecutar script de PowerShell en una secuencia de tareas.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSStepRunPowerShellScript":{"href":"new-cmtssteprunpowershellscript","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRunPowerShellScript","schemaType":"PowershellCmdlet","summary":"Cree el paso Ejecutar script de PowerShell en una secuencia de tareas.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}},"description":"Este cmdlet crea un nuevo objeto de paso Ejecutar script de PowerShell . 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 Acerca de los pasos de secuencia de tareas: Ejecutar script de PowerShell.
\nNota:
\nEjecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\\>. Para obtener más información, consulte Introducción.
En este ejemplo se crea primero un objeto para el paso Ejecutar script de PowerShell . Especifica el paquete con el nombre del script que se va a ejecutar. Establece la directiva de ejecución de PowerShell en el nivel AllSigned más seguro, lo que requiere que el script se firme digitalmente.
\nA continuación, obtiene un objeto de secuencia de tareas y agrega este nuevo paso a la secuencia de tareas en el índice 11.
\n","title":"Ejemplo 1"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"get-cmtssteprunpowershellscript","text":"Get-CMTSStepRunPowerShellScript"},{"href":"remove-cmtssteprunpowershellscript","text":"Remove-CMTSStepRunPowerShellScript"},{"href":"set-cmtssteprunpowershellscript","text":"Set-CMTSStepRunPowerShellScript"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_RunPowerShellScript","text":"Acerca de los pasos de secuencia de tareas: Ejecutar script de PowerShell"}],"module":"ConfigurationManager","name":"New-CMTSStepRunPowerShellScript","notes":"Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_RunPowerShellScriptAction clase WMI de servidor.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"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.
\n","name":"Condition","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"cf","defaultValue":"None","description":"Solicitará confirmación antes de ejecutar el cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Agregue este parámetro para habilitar la opción de paso Continuar en caso de error. Al habilitar esta opción, si se produce un error en el paso, la secuencia de tareas continúa.
\n","name":"ContinueOnError","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique una descripción opcional para este paso de secuencia de tareas.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"Agregue este parámetro para deshabilitar este paso de secuencia de tareas.
\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"PowerShellExecutionPolicy","defaultValue":"None","description":"Especifique la directiva de ejecución de PowerShell para los scripts que permite ejecutar en el equipo. Elija una de las directivas siguientes:
\n\n AllSigned: ejecute solo scripts firmados por un publicador de confianza.
\n Undefined: no defina ninguna directiva de ejecución.
\n Bypass: cargue todos los archivos de configuración y ejecute todos los scripts. Si descarga un script sin firmar desde Internet, PowerShell no solicitará permiso antes de ejecutar el script.
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StepName","defaultValue":"None","description":"Especifique un nombre para este paso para identificarlo en la secuencia de tareas.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Output, OutputVariable","defaultValue":"None","description":"Especifique el nombre de una variable de secuencia de tareas personalizada. Cuando se usa este parámetro, el paso guarda los últimos 1000 caracteres de la salida del comando en la variable.
\n","name":"OutputVariableName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique el identificador del paquete que tiene el script de PowerShell. El paquete no requiere un programa. Un paquete puede contener varios scripts.
\nEste valor es un identificador de paquete estándar, por ejemplo XYZ00821.
A continuación, use el parámetro ScriptName para especificar el nombre del script.
\n","isRequired":true,"name":"PackageId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Parameters","defaultValue":"None","description":"Especifique los parámetros pasados al script de PowerShell. Estos parámetros son los mismos que los parámetros de script de PowerShell en la línea de comandos. Proporcione los parámetros consumidos por el script, no para la línea de comandos de PowerShell.
\nEl ejemplo siguiente contiene parámetros válidos :
\n-MyParameter1 MyValue1 -MyParameter2 MyValue2
El ejemplo siguiente contiene parámetros no válidos . Los dos primeros elementos son parámetros de línea de comandos de PowerShell (NoLogo y ExecutionPolicy). El script no consume estos parámetros.
\n-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2
Si un valor de parámetro incluye un carácter especial o un espacio, use comillas simples (') alrededor del valor. El uso de comillas dobles (") puede hacer que el paso de secuencia de tareas procese incorrectamente el parámetro.
Por ejemplo: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'
También puede establecer este parámetro en una variable de secuencia de tareas. Por ejemplo, si especifica %MyScriptVariable%, cuando la secuencia de tareas ejecuta el script, agrega el valor de esta variable personalizada a la línea de comandos de PowerShell.
Especifique el nombre del script que se va a ejecutar. Este script está en el paquete especificado por el parámetro PackageId .
\n","isRequired":true,"name":"ScriptName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"SourceCode","defaultValue":"None","description":"En lugar de usar los parámetros PackageId y ScriptName , use este parámetro para especificar directamente los comandos de script. Este valor de cadena son los comandos de PowerShell que ejecuta este paso.
\nPuede leer el contenido de un archivo de script existente en una variable de cadena y, a continuación, usar esa variable para este parámetro. Por ejemplo:
\n$script = [IO.File]::ReadAllText( "C:\\temp\\script.ps1" )
Especifique una matriz de valores enteros como códigos de salida del script que el paso debe evaluar como correcto.
\n","name":"SuccessCode","parameterValueGroup":"","position":"Named","type":"Int32[]
\n"},{"aliases":"TimeoutInMinutes","defaultValue":"None","description":"Especifique un valor entero que represente cuánto tiempo Configuration Manager permite que se ejecute el script. 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 script 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 el tiempo de espera expira, Configuration Manager finaliza el proceso de PowerShell.
\n","name":"TimeoutMins","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"User","defaultValue":"None","description":"Use este parámetro para ejecutar el script como una cuenta de usuario de Windows y no como la cuenta del sistema local. Especifique el nombre de la cuenta de usuario de Windows. Para especificar la contraseña de la cuenta, use el parámetro UserPassword .
\n","name":"UserName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Password","defaultValue":"None","description":"Use este parámetro para especificar la contraseña de la cuenta que especifique con UserName.
\n","name":"UserPassword","parameterValueGroup":"","position":"Named","type":"SecureString\n"},{"aliases":"wi","defaultValue":"None","description":"Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StartIn","defaultValue":"None","description":"Especifique la carpeta en la que se inicia el comando. Esta ruta de acceso puede tener hasta 127 caracteres.
\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"Cree el paso Ejecutar script de PowerShell en una secuencia de tareas.
\n","syntaxes":["New-CMTSStepRunPowerShellScript -NameCree el paso Ejecutar script de PowerShell en una secuencia de tareas.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"canonical_url":"https://learn.microsoft.com/es-es/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/es-es/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps"},"pageMetadata":"Este cmdlet crea un nuevo objeto de paso Ejecutar script de PowerShell . 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 Acerca de los pasos de secuencia de tareas: Ejecutar script de PowerShell.\nNota:
\nEjecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\\>. Para obtener más información, consulte Introducción.