New-CMTSStepInstallSoftware
Crea un passaggio Installa pacchetto, che puoi aggiungere a una sequenza di attività.
Sintassi
New-CMTSStepInstallSoftware
[-BaseVariableName <String>]
[-ContinueOnInstallError]
[-Program <IResultObject>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Questo cmdlet crea un nuovo oggetto passaggio Installa pacchetto. 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: Install Package.
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 utilizzato il cmdlet Get-CMProgram per ottenere il programma di installazione dal pacchetto con ID XYZ0000F.
La riga successiva crea un oggetto per il passaggio Installa pacchetto, utilizzando la variabile di programma.
Ottiene quindi un oggetto della sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 11.
$program = Get-CMProgram -PackageId "XYZ0000F" -ProgramName "Install"
$step = New-CMTSStepInstallSoftware -Name "Install Package" -Program $program
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parametri
-BaseVariableName
Utilizzare questo parametro per installare i pacchetti software in base a un elenco di variabili dinamiche. La sequenza di attività installa quindi i pacchetti usando questo nome di variabile di base. Per ulteriori informazioni, vedere Install software packages according to dynamic variable list.
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 |
-ContinueOnInstallError
Aggiungi questo parametro per continuare a installare altri pacchetti nell'elenco se l'installazione di un pacchetto non riesce. Se non si specifica questa impostazione e l'installazione non riesce, il passaggio termina immediatamente.
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 |
-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 |
-Program
Specificare un oggetto programma da un pacchetto da installare. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMProgram.
Type: | IResultObject |
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 |
Input
Nessuno
Output
IResultObject
Note
Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_InstallSoftwareAction WMI server.