New-CMTSStepRunCommandLine

Creare un passaggio Esegui riga di comando , che è possibile aggiungere a una sequenza di attività.

Sintassi

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>]

Descrizione

Questo cmdlet crea un nuovo oggetto passaggio Esegui riga di comando . Usare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per altre informazioni su questo passaggio, vedere Informazioni sui passaggi della sequenza di attività: Eseguire la riga di comando.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio viene innanzitutto creato un oggetto per il passaggio Esegui riga di comando . Specifica la riga di comando e un pacchetto da usare.

Ottiene quindi un oggetto sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 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

Parametri

-CommandLine

Specificare la riga di comando eseguita dalla sequenza di attività. Includere le estensioni del nome file, ad esempio . .exe Includere tutti i file di impostazioni e le opzioni della riga di comando necessari.

Ad esempio: cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Condition

Specificare un oggetto condizione da usare con questo passaggio. Per ottenere questo oggetto, usare uno dei cmdlet della condizione della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Alias:Conditions
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContinueOnError

Aggiungere questo parametro per abilitare l'opzione di passaggio Continua in caso di errore. Quando si abilita questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Disable

Aggiungere questo parametro per disabilitare questo passaggio della sequenza di attività.

Tipo:SwitchParameter
Alias:DisableThisStep
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWow64Redirection

Per impostazione predefinita, i sistemi operativi a 64 bit usano il reindirizzatore del file system WOW64 per eseguire le righe di comando. Questo comportamento consiste nel trovare correttamente le versioni a 32 bit di file eseguibili e librerie del sistema operativo. Aggiungere questo parametro per disabilitare l'uso del reindirizzatore del file system WOW64. Windows esegue il comando usando versioni native a 64 bit di file eseguibili e librerie del sistema operativo. Questa opzione non ha alcun effetto durante l'esecuzione in un sistema operativo a 32 bit.

Tipo:SwitchParameter
Alias:DisableRedirectionFor64BitFileSystem
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.

Tipo:String
Alias:StepName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OutputVariableName

Specificare il nome di una variabile della sequenza di attività personalizzata. Quando si usa questo parametro, il passaggio salva gli ultimi 1000 caratteri dell'output del comando nella variabile.

Tipo:String
Alias:Output, OutputVariable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PackageId

Quando si specificano file o programmi nella riga di comando che non esistono già nel computer di destinazione, usare questo parametro per specificare l'ID del pacchetto per un pacchetto con i file necessari. Il pacchetto non richiede un programma. Se i file specificati esistono nel computer di destinazione, questa opzione non è necessaria.

Questo valore è un ID pacchetto standard, ad esempio XYZ00821.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsUser

Aggiungere questo parametro per eseguire la riga di comando come account utente di Windows e non come account di sistema locale. Usare quindi i parametri UserName e UserPassword .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SuccessCode

Specificare una matrice di valori integer come codici di uscita dal comando che il passaggio deve valutare come esito positivo.

Tipo:Int32[]
Alias:SuccessCodes
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Timeout

Specificare un valore intero che rappresenta il tempo per cui Configuration Manager consente l'esecuzione della riga di comando. Questo valore può essere compreso tra 1 minuti e 999 minuti. Il valore predefinito è 15 minuti.

Se si immette un valore che non consente il completamento del comando specificato, questo passaggio avrà esito negativo. L'intera sequenza di attività potrebbe non riuscire a seconda delle condizioni del passaggio o del gruppo. Se il timeout scade, Configuration Manager termina il processo della riga di comando.

Tipo:Int32
Alias:TimeoutInMinutes
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserName

Quando si usa il parametro RunAsUser , usare questo parametro per specificare il nome dell'account utente di Windows. Per specificare la password dell'account, usare il parametro UserPassword .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserPassword

Quando si usa il parametro RunAsUser , usare questo parametro per specificare la password dell'account specificato con UserName.

Tipo:SecureString
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WorkingDirectory

Specificare la cartella in cui viene avviato il comando. Questo percorso può contenere fino a 127 caratteri.

Tipo:String
Alias:StartIn
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_RunCommandLineAction classe WMI del server.