New-CMTSStepRunPowerShellScript

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.

Richiede la conferma prima di eseguire il cmdlet.

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.

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

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

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

Specificare i criteri di esecuzione di PowerShell per gli script consentiti per l'esecuzione nel computer. Scegliere uno dei criteri seguenti:

• AllSigned: esegue solo script firmati da un autore attendibile.

• Undefined: non definire criteri di esecuzione.

• Bypass: caricare tutti i file di configurazione ed eseguire tutti gli script. Se si scarica uno script non firmato da Internet, PowerShell non richiede l'autorizzazione prima di eseguire lo script.

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

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

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.

Specificare l'ID pacchetto per il pacchetto con lo script di PowerShell. Il pacchetto non richiede un programma. Un pacchetto può contenere più script.

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

Usare quindi il parametro ScriptName per specificare il nome dello script.

Specificare i parametri passati allo script di PowerShell. Questi parametri sono gli stessi dei parametri di script di PowerShell nella riga di comando. Specificare i parametri utilizzati dallo script, non per la riga di comando di PowerShell.

L'esempio seguente contiene parametri validi :

-MyParameter1 MyValue1 -MyParameter2 MyValue2

L'esempio seguente contiene parametri non validi . I primi due elementi sono parametri della riga di comando di PowerShell (NoLogo ed ExecutionPolicy). Lo script non usa questi parametri.

-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2

Se un valore di parametro include un carattere speciale o uno spazio, usare virgolette singole (') intorno al valore. L'uso di virgolette doppie (") può causare l'elaborazione errata del parametro da parte del passaggio della sequenza di attività.

Ad esempio: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'

È anche possibile impostare questo parametro su una variabile della sequenza di attività. Ad esempio, se si specifica %MyScriptVariable%, quando la sequenza di attività esegue lo script, aggiunge il valore di questa variabile personalizzata alla riga di comando di PowerShell.

Specificare il nome dello script da eseguire. Questo script si trova nel pacchetto specificato dal parametro PackageId .

Anziché usare i parametri PackageId e ScriptName , usare questo parametro per specificare direttamente i comandi dello script. Questo valore stringa è costituito dai comandi di PowerShell eseguiti in questo passaggio.

È possibile leggere il contenuto di un file di script esistente in una variabile stringa e quindi usare tale variabile per questo parametro. Ad esempio:

$script = [IO.File]::ReadAllText( "C:\temp\script.ps1" )

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

Specificare un valore intero che rappresenta per quanto tempo Configuration Manager consente l'esecuzione dello script. 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 dello script 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 di PowerShell.

Usare questo parametro per eseguire lo script come account utente di Windows e non come account di sistema locale. Specificare il nome dell'account utente di Windows. Per specificare la password dell'account, usare il parametro UserPassword .

Usare questo parametro per specificare la password dell'account specificato con UserName.

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

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