New-CMTSStepRunCommandLine
Crea un passaggio Esegui riga di comando, che puoi 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. Utilizzare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per ulteriori informazioni su questo passaggio, vedere About task sequence steps: Run Command Line.
Nota
Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori 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 utilizzare.
Ottiene quindi un oggetto della 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 11Parametri
-CommandLine
Specificare la riga di comando in cui viene eseguita la sequenza di attività. Includere le estensioni di file, ad esempio .exe . Includere tutti i file di impostazioni necessari e le opzioni della riga di comando.
Ad esempio: cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Condition
Specificare un oggetto condizione da utilizzare con questo passaggio. Per ottenere questo oggetto, utilizzare uno dei cmdlet delle condizioni della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinueOnError
Aggiungere questo parametro per abilitare l'opzione del passaggio Continua in caso di errore. Quando abiliti questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disable
Aggiungi questo parametro per disabilitare questo passaggio della sequenza di attività.
| Type: | SwitchParameter |
| Aliases: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWow64Redirection
Per impostazione predefinita, i sistemi operativi a 64 bit utilizzano il redirector del file system WOW64 per eseguire le righe di comando. Questo comportamento è quello di trovare correttamente le versioni a 32 bit di file eseguibili e librerie del sistema operativo. Aggiungere questo parametro per disabilitare l'utilizzo del redirector del file system WOW64. Windows il comando viene eseguito utilizzando versioni native a 64 bit di file eseguibili e librerie del sistema operativo. Questa opzione non ha alcun effetto quando viene eseguita su un sistema operativo a 32 bit.
| Type: | SwitchParameter |
| Aliases: | DisableRedirectionFor64BitFileSystem |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.
| Type: | String |
| Aliases: | StepName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputVariableName
Specificare il nome di una variabile della sequenza di attività personalizzata. Quando si utilizza questo parametro, il passaggio salva gli ultimi 1000 caratteri dell'output del comando nella variabile.
| Type: | String |
| Aliases: | Output, OutputVariable |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
Quando si specificano file o programmi nella riga di comando che non esistono già nel computer di destinazione, utilizzare 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 sono presenti nel computer di destinazione, questa opzione non è necessaria.
Questo valore è un ID pacchetto standard, ad esempio XYZ00821 .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsUser
Aggiungere questo parametro per eseguire la riga di comando come Windows utente e non come account di sistema locale. Utilizzare quindi i parametri UserName e UserPassword.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuccessCode
Specificare una matrice di valori interi come codici di uscita dal comando che il passaggio deve valutare come esito positivo.
| Type: | Int32[] |
| Aliases: | SuccessCodes |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Timeout
Specificare un valore intero che rappresenta per quanto tempo Configuration Manager consente l'esecuzione della riga di comando. Questo valore può essere compreso 1 tra minuti 999 e minuti. Il valore predefinito è 15 minuti.
Se si immette un valore che non consente il corretto completamento del comando specificato, questo passaggio ha 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.
| Type: | Int32 |
| Aliases: | TimeoutInMinutes |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
Quando si utilizza il parametro RunAsUser, utilizzare questo parametro per specificare il nome dell Windows utente. Per specificare la password dell'account, utilizzare il parametro UserPassword.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPassword
Quando si utilizza il parametro RunAsUser, utilizzare questo parametro per specificare la password dell'account specificato con UserName.
| Type: | SecureString |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
Specificare la cartella in cui viene avviato il comando. Questo percorso può contenere fino a 127 caratteri.
| Type: | String |
| Aliases: | StartIn |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
Nessuno
Output
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_RunCommandLineAction WMI server.