Crie o passo Executar Script do PowerShell numa 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 o passo Executar Script do PowerShell numa sequência de tarefas.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}},"description":"Este cmdlet cria um novo objeto de passo Executar Script do PowerShell . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja About task sequence steps: Run PowerShell Script (Sobre os passos da sequência de tarefas: Executar o Script do PowerShell).
\nObservação
\nExecute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\\>. Para obter mais informações, veja Introdução.
Este exemplo cria primeiro um objeto para o passo Executar Script do PowerShell . Especifica o pacote com o nome do script a executar. Define a política de execução do PowerShell para o nível AllSigned mais seguro, o que requer que o script seja assinado digitalmente.
\nEm seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à 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":"Acerca dos passos de sequência de tarefas: Executar o Script do PowerShell"}],"module":"ConfigurationManager","name":"New-CMTSStepRunPowerShellScript","notes":"Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_RunPowerShellScriptAction classe WMI de servidor.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"Especifique um objeto de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da 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 ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo 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 este passo de sequência de tarefas.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"Adicione este parâmetro para desativar este passo de sequência de tarefas.
\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parâmetro trata os carateres universais como valores de carateres literais. 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 permite executar no computador. Escolha uma das seguintes políticas:
\n\n AllSigned: execute apenas scripts assinados por um fabricante fidedigno.
\n Undefined: não defina nenhuma política de execução.
\n Bypass: carregue todos os ficheiros de configuração e execute todos os scripts. Se transferir um script não assinado a partir da Internet, o PowerShell não pede permissão antes de executar o script.
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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 este passo para identificá-lo 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 utiliza este parâmetro, o passo guarda os últimos 1000 carateres da saída do comando na variável .
\n","name":"OutputVariableName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique o ID do pacote que tem o script do PowerShell. O pacote não requer um programa. Um pacote pode conter vários scripts.
\nEste valor é um ID de pacote padrão, por exemplo XYZ00821.
Em seguida, utilize 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 transmitidos para o script do PowerShell. Estes parâmetros são os mesmos que os parâmetros de script do PowerShell na linha de comandos. Forneça parâmetros consumidos pelo script e não para a linha de comandos do PowerShell.
\nO exemplo seguinte contém parâmetros válidos :
\n-MyParameter1 MyValue1 -MyParameter2 MyValue2
O exemplo seguinte contém parâmetros inválidos . Os dois primeiros itens são parâmetros da linha de comandos do PowerShell (NoLogo e ExecutionPolicy). O script não consome estes parâmetros.
\n-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2
Se um valor de parâmetro incluir um caráter especial ou um espaço, utilize plicas (') à volta do valor. A utilização de aspas duplas (") pode fazer com que o passo de sequência de tarefas processe incorretamente o parâmetro.
Por exemplo: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'
Também pode definir este parâmetro para uma variável de sequência de tarefas. Por exemplo, se especificar %MyScriptVariable%, quando a sequência de tarefas executa o script, adiciona o valor desta variável personalizada à linha de comandos do PowerShell.
Especifique o nome do script a executar. Este 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 utilizar os parâmetros PackageId e ScriptName , utilize este parâmetro para especificar diretamente os comandos de script. Este valor de cadeia é os comandos do PowerShell que este passo executa.
\nPode ler o conteúdo de um ficheiro de script existente numa variável de cadeia e, em seguida, utilizar essa variável para este 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 o passo deve avaliar como bem-sucedido.
\n","name":"SuccessCode","parameterValueGroup":"","position":"Named","type":"Int32[]
\n"},{"aliases":"TimeoutInMinutes","defaultValue":"None","description":"Especifique um valor inteiro que represente durante quanto tempo o Configuration Manager permite a execução do script. Este valor pode ser de 1 minuto a 999 minuto. O valor predefinido é 15 minutos.
Se introduzir um valor que não permita tempo suficiente para que o script especificado seja concluído com êxito, este passo falhará. Toda a sequência de tarefas pode falhar consoante as condições do passo ou do grupo. Se o tempo limite expirar, o Configuration Manager terminará o processo do PowerShell.
\n","name":"TimeoutMins","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"User","defaultValue":"None","description":"Utilize este parâmetro para executar o script como uma conta de utilizador do Windows e não como a conta do sistema local. Especifique o nome da conta de utilizador do Windows. Para especificar a palavra-passe da conta, utilize o parâmetro UserPassword .
\n","name":"UserName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Password","defaultValue":"None","description":"Utilize este parâmetro para especificar a palavra-passe da conta que especificar 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 é iniciado. Este caminho pode ter até 127 carateres.
\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"Crie o passo Executar Script do PowerShell numa sequência de tarefas.
\n","syntaxes":["New-CMTSStepRunPowerShellScript -NameCrie o passo Executar Script do PowerShell numa 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 passo Executar Script do PowerShell . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja About task sequence steps: Run PowerShell Script (Sobre os passos da sequência de tarefas: Executar o Script do PowerShell).\nObservação
\nExecute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\\>. Para obter mais informações, veja Introdução.