Crie a etapa Executar Script do PowerShell em uma sequência de tarefas.
\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":"Crie a etapa Executar Script do PowerShell em uma sequência de tarefas.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}},"description":"Este cmdlet cria um novo objeto de etapa Executar Script do PowerShell . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre essa etapa, consulte Sobre as etapas de sequência de tarefas: Executar script do PowerShell.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Primeiro, esse exemplo cria um objeto para a etapa Executar Script do PowerShell . Ele especifica o pacote com o nome do script a ser executado. Ele define a política de execução do PowerShell para o nível AllSigned mais seguro, o que exige que o script seja assinado digitalmente.
\nEm seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 11.
\n","title":"Exemplo 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":"Sobre as etapas de sequência de tarefas: Executar Script do PowerShell"}],"module":"ConfigurationManager","name":"New-CMTSStepRunPowerShellScript","notes":"Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_TaskSequence_RunPowerShellScriptAction classe WMI do servidor.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"Especifique um objeto de condição a ser usado nesta etapa. Para obter esse objeto, use um dos cmdlets de condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
\n","name":"Condition","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"cf","defaultValue":"None","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Adicione este parâmetro para habilitar a opção de etapa Continuar com erro. Quando você habilitar essa opção, se a etapa falhar, a sequência de tarefas continuará.
\n","name":"ContinueOnError","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma descrição opcional para essa etapa da sequência de tarefas.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.
\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"PowerShellExecutionPolicy","defaultValue":"None","description":"Especifique a política de execução do PowerShell para os scripts que você permite executar no computador. Escolha uma das seguintes políticas:
\n\n AllSigned: execute apenas scripts assinados por um fornecedor confiável.
\n Undefined: não defina nenhuma política de execução.
\n Bypass: carregue todos os arquivos de configuração e execute todos os scripts. Se você baixar um script não assinado da Internet, o PowerShell não solicitará permissão antes de executar o script.
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StepName","defaultValue":"None","description":"Especifique um nome para esta etapa para identificá-la na sequência de tarefas.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Output, OutputVariable","defaultValue":"None","description":"Especifique o nome de uma variável de sequência de tarefas personalizada. Quando você usa esse parâmetro, a etapa salva os últimos 1000 caracteres da saída do comando na variável.
\n","name":"OutputVariableName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique a ID do pacote que tem o script do PowerShell. O pacote não requer um programa. Um pacote pode conter vários scripts.
\nEsse valor é uma ID de pacote padrão, por exemplo XYZ00821.
Em seguida, use o parâmetro ScriptName para especificar o nome do script.
\n","isRequired":true,"name":"PackageId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Parameters","defaultValue":"None","description":"Especifique os parâmetros passados para o script do PowerShell. Esses parâmetros são os mesmos parâmetros do script PowerShell na linha de comando. Forneça os parâmetros consumidos pelo script, não para a linha de comando do PowerShell.
\nO exemplo a seguir contém parâmetros válidos :
\n-MyParameter1 MyValue1 -MyParameter2 MyValue2
O exemplo a seguir contém parâmetros inválidos . Os dois primeiros itens são parâmetros de linha de comando do PowerShell (NoLogo e ExecutionPolicy). O script não consome esses parâmetros.
\n-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2
Se um valor de parâmetro incluir um caractere especial ou um espaço, use aspas simples (') ao redor do valor. O uso de aspas duplas (") pode fazer com que a etapa de sequência de tarefas processe incorretamente o parâmetro.
Por exemplo: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'
Você também pode definir esse parâmetro como uma variável de sequência de tarefas. Por exemplo, se você especificar %MyScriptVariable%, quando a sequência de tarefas executar o script, ela adicionará o valor dessa variável personalizada à linha de comando do PowerShell.
Especifique o nome do script a ser executado. Esse script está no pacote especificado pelo parâmetro PackageId .
\n","isRequired":true,"name":"ScriptName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"SourceCode","defaultValue":"None","description":"Em vez de usar os parâmetros PackageId e ScriptName , use esse parâmetro para especificar diretamente os comandos de script. Esse valor de cadeia de caracteres são os comandos do PowerShell executados por esta etapa.
\nVocê pode ler o conteúdo de um arquivo de script existente em uma variável de cadeia de caracteres e, em seguida, usar essa variável para esse parâmetro. Por exemplo:
\n$script = [IO.File]::ReadAllText( "C:\\temp\\script.ps1" )
Especifique uma matriz de valores inteiros como códigos de saída do script que a etapa deve avaliar como bem-sucedida.
\n","name":"SuccessCode","parameterValueGroup":"","position":"Named","type":"Int32[]
\n"},{"aliases":"TimeoutInMinutes","defaultValue":"None","description":"Especifique um valor inteiro que represente por quanto tempo o Configuration Manager permite que o script seja executado. Esse valor pode ser de 1 minuto a 999 minuto. O valor padrão é 15 minutos.
Se você inserir um valor que não permita tempo suficiente para que o script especificado seja concluído com êxito, esta etapa falhará. Toda a sequência de tarefas pode falhar dependendo das condições da etapa ou do grupo. Se o tempo limite expirar, o Configuration Manager encerrará o processo do PowerShell.
\n","name":"TimeoutMins","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"User","defaultValue":"None","description":"Use esse parâmetro para executar o script como uma conta de usuário do Windows e não como a conta do sistema local. Especifique o nome da conta de usuário do Windows. Para especificar a senha da conta, use o parâmetro UserPassword .
\n","name":"UserName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Password","defaultValue":"None","description":"Use este parâmetro para especificar a senha da conta especificada com UserName.
\n","name":"UserPassword","parameterValueGroup":"","position":"Named","type":"SecureString\n"},{"aliases":"wi","defaultValue":"None","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StartIn","defaultValue":"None","description":"Especifique a pasta na qual o comando será iniciado. Esse caminho pode ter até 127 caracteres.
\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"Crie a etapa Executar Script do PowerShell em uma sequência de tarefas.
\n","syntaxes":["New-CMTSStepRunPowerShellScript -NameCrie a etapa Executar Script do PowerShell em uma sequência de tarefas.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps"},"pageMetadata":"Este cmdlet cria um novo objeto de etapa Executar Script do PowerShell . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre essa etapa, consulte Sobre as etapas de sequência de tarefas: Executar script do PowerShell.\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.