Set-CMTaskSequence

  • Riferimento
Modulo:
ConfigurationManager

Imposta una sequenza di attività di Configuration Manager.

Sintassi

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   -InputObject <IResultObject>
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceId <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceName <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-CMTaskSequence modifica una sequenza di attività di Configuration Manager.

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: Ottenere una sequenza di attività e modificarne il nome

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"

Il primo comando ottiene l'oggetto sequenza di attività denominato TaskSequence01 e archivia l'oggetto nella variabile $TaskSequence.

Il secondo comando modifica il nome della sequenza di attività archiviata in $TaskSequence in NewTS01.

Esempio 2: Passare una sequenza di attività e modificarne il nome

PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"

Questo comando ottiene l'oggetto sequenza di attività denominato TaskSequence02 e usa l'operatore della pipeline per passare l'oggetto a Set-CMTaskSequence, che modifica il nome dell'oggetto sequenza di attività in NewTS02.

Parametri

-AddSupportedOperatingSystemPlatform

Aggiunge un oggetto piattaforma del sistema operativo supportato alla sequenza di attività. Per ottenere un oggetto piattaforma del sistema operativo supportato, usare il cmdlet Get-CMSupportedPlatform .

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

-BootImageId

Specifica l'ID di un'immagine di avvio.

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

-Category

Specifica una categoria per la sequenza di attività. È possibile usare le categorie per raggruppare le sequenze di attività.

Tipo:String
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:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CustomText

Specifica il testo personalizzato per la sequenza di attività. Il testo personalizzato viene visualizzato nella finestra di dialogo di notifica dello stato durante l'esecuzione della sequenza di attività.

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

-DeploymentPackageId

Specifica l'ID di un pacchetto. Se si specifica un valore di $True per il parametro RunAnotherProgram , il pacchetto specificato viene eseguito prima dell'esecuzione della sequenza di attività.

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

-Description

Specifica una descrizione per la sequenza di attività.

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

-DisableTaskSequence

Indica se disabilitare questa sequenza di attività.

Tipo:Boolean
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

-EnableNotification

Indica se abilitare le notifiche per questa sequenza di attività.

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

-EnableTaskSequence

Indica se abilitare questa sequenza di attività.

Tipo:Boolean
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

-HighPerformance

Usare questo parametro per impostare l'opzione seguente nella pagina Prestazioni delle proprietà della sequenza di attività: Eseguire come combinazione per il risparmio di energia a prestazioni elevate.

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

-InputObject

Specifica un oggetto sequenza di attività. Per ottenere un oggetto sequenza di attività, usare il cmdlet Get-CMTaskSequence .

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

-MaxRunTimeMins

Specifica, in minuti, il tempo di esecuzione massimo per la sequenza di attività.

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

-NewName

Specifica un nuovo nome per la sequenza di attività.

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

-PassThru

Restituisce l'oggetto di lavoro corrente. Per impostazione predefinita, il cmdlet non genera alcun output.

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

-ProgramName

Specifica il nome di un programma da eseguire da un pacchetto software di Configuration Manager specificato dal parametro DeploymentPackageId .

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

-RemoveSupportedOperatingSystemPlatform

Rimuove un oggetto piattaforma del sistema operativo supportato dalla sequenza di attività. Per ottenere un oggetto piattaforma del sistema operativo supportato, usare il cmdlet Get-CMSupportedPlatform .

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

-RunAnotherProgram

Indica se eseguire un altro programma prima di eseguire la sequenza di attività. Specificare il programma usando il parametro DeploymentPackageId e il parametro ProgramName .

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

-RunEveryTime

Indica se il programma specificato nel parametro ProgramName viene eseguito ogni volta che viene eseguita la sequenza di attività. Se si specifica un valore di $False, il programma non viene eseguito se è stato eseguito correttamente in passato.

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

-RunOnAnyPlatform

Indica che la sequenza di attività viene eseguita in qualsiasi piattaforma del sistema operativo.

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

-SuppressNotification

Indica se eliminare le notifiche per questa sequenza di attività.

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

-TaskSequenceId

Specifica l'ID di una sequenza di attività.

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

-TaskSequenceName

Specifica il nome di una sequenza di attività.

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

-UseBootImage

Indica se la sequenza di attività usa l'immagine di avvio specificata usando il parametro BootImageID .

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

-UseDefaultText

Indica se usare il testo predefinito nella finestra di dialogo di notifica dello stato durante l'esecuzione della sequenza di attività. Se si seleziona un valore di $False per questo parametro, assicurarsi di specificare testo personalizzato usando il parametro CustomText .

Tipo:Boolean
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:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object