New-CMTSStepRunCommandLine

Crie um passo Executar Linha de Comandos , que pode adicionar a uma sequência de tarefas.

Sintaxe

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 cria um novo objeto de passo Executar Linha de Comandos . 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 Acerca dos passos da sequência de tarefas: Executar Linha de Comandos.

Observação

Execute 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.

Exemplos

Exemplo 1

Este exemplo cria primeiro um objeto para o passo Executar Linha de Comandos . Especifica a linha de comandos e um pacote a utilizar.

Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à sequência de tarefas no í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

-CommandLine

Especifique a linha de comandos que a sequência de tarefas executa. Inclua extensões de nome de ficheiro, por exemplo, .exe. Inclua todos os ficheiros de definições necessários e as opções da linha de comandos.

Por exemplo: cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Condition

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.

Tipo:IResultObject[]
Aliases:Conditions
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContinueOnError

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á.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para este passo de sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Disable

Adicione este parâmetro para desativar este passo de sequência de tarefas.

Tipo:SwitchParameter
Aliases:DisableThisStep
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWow64Redirection

Por predefinição, os sistemas operativos de 64 bits utilizam o redirecionador do sistema de ficheiros WOW64 para executar linhas de comandos. Este comportamento consiste em encontrar corretamente versões de 32 bits de executáveis e bibliotecas do SO. Adicione este parâmetro para desativar a utilização do redirecionador do sistema de ficheiros WOW64. O Windows executa o comando com versões nativas de 64 bits de executáveis e bibliotecas do SO. Esta opção não tem efeito quando é executada num SO de 32 bits.

Tipo:SwitchParameter
Aliases:DisableRedirectionFor64BitFileSystem
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para este passo para identificá-lo na sequência de tarefas.

Tipo:String
Aliases:StepName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OutputVariableName

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 .

Tipo:String
Aliases:Output, OutputVariable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageId

Quando especificar ficheiros ou programas na linha de comandos que ainda não existem no computador de destino, utilize este parâmetro para especificar o ID do pacote para um pacote que tenha os ficheiros necessários. O pacote não requer um programa. Se os ficheiros especificados existirem no computador de destino, esta opção não é necessária.

Este valor é um ID de pacote padrão, por exemplo XYZ00821.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsUser

Adicione este parâmetro para executar a linha de comandos como uma conta de utilizador do Windows e não como a conta do sistema local. Em seguida, utilize os parâmetros UserName e UserPassword .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SuccessCode

Especifique uma matriz de valores inteiros como códigos de saída do comando que o passo deve avaliar como bem-sucedido.

Tipo:Int32[]
Aliases:SuccessCodes
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Timeout

Especifique um valor inteiro que represente durante quanto tempo o Configuration Manager permite a execução da linha de comandos. 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 comando 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 termina o processo da linha de comandos.

Tipo:Int32
Aliases:TimeoutInMinutes
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserName

Quando utilizar o parâmetro RunAsUser , utilize este parâmetro para especificar o nome da conta de utilizador do Windows. Para especificar a palavra-passe da conta, utilize o parâmetro UserPassword .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserPassword

Quando utilizar o parâmetro RunAsUser , utilize este parâmetro para especificar a palavra-passe da conta que especificar com o Nome de Utilizador.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WorkingDirectory

Especifique a pasta na qual o comando é iniciado. Este caminho pode ter até 127 carateres.

Tipo:String
Aliases:StartIn
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_RunCommandLineAction classe WMI de servidor.