Set-CMTaskSequence

Artykuł
08/11/2021

SYNOPSIS

Ustawia Menedżer konfiguracji zadań.

SYNTAX

SetByValue (wartość domyślna)

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

SetById

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

SetByName

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

DESCRIPTION

Polecenie cmdlet Set-CMTaskSequence modyfikuje Menedżer konfiguracji sekwencji zadań.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Pobierz sekwencję zadań i zmień jej nazwę

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

Pierwsze polecenie pobiera obiekt sekwencji zadań o nazwie TaskSequence01 i zapisuje obiekt w zmiennej $TaskSequence zadań.

Drugie polecenie zmienia nazwę sekwencji zadań przechowywanej w programie $TaskSequence na NewTS01.

Przykład 2: Przekaż sekwencję zadań i zmień jej nazwę

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

To polecenie pobiera obiekt sekwencji zadań o nazwie TaskSequence02 i używa operatora potoku do przekazania obiektu do polecenia Set-CMTaskSequence, co zmienia nazwę obiektu sekwencji zadań na NewTS02.

PARAMETERS

-AddSupportedOperatingSystemPlatform

Dodaje do sekwencji zadań obsługiwany obiekt platformy systemu operacyjnego. Aby uzyskać obsługiwany obiekt platformy systemu operacyjnego, użyj polecenia cmdlet Get-CMSupportedPlatform.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddSupportedOperatingSystemPlatforms

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-BootImageId

Określa identyfikator obrazu rozruchowego.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Category (Kategoria)

Określa kategorię sekwencji zadań. Do grupowania sekwencji zadań można używać kategorii.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-CustomText

Określa tekst niestandardowy sekwencji zadań. Tekst niestandardowy jest wyświetlany w oknie dialogowym powiadomienia o postępie, gdy sekwencja zadań jest uruchamiana.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentPackageId

Określa identyfikator pakietu. Jeśli określisz wartość $True parametru RunAnotherProgram, określony pakiet zostanie uruchomiony przed uruchomieniem sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Description (Opis)

Określa opis sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableTaskSequence

Wskazuje, czy ta sekwencja zadań ma być wyłączana.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableNotification

Wskazuje, czy włączyć powiadomienia dla tej sekwencji zadań.

Type: Boolean
Parameter Sets: (All)
Aliases: EnableNotifications

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableTaskSequence

Wskazuje, czy włączyć tę sekwencję zadań.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-HighPerformance (Wysoka wydajność)

Począwszy od wersji 1910, użyj tego parametru, aby ustawić następującą opcję na stronie Wydajność właściwości sekwencji zadań: Uruchom jako plan zasilania o wysokiej wydajności.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Określa obiekt sekwencji zadań. Aby uzyskać obiekt sekwencji zadań, użyj polecenia cmdlet Get-CMTaskSequence.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: TaskSequence

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-MaxRunTimeMins

Określa w minutach maksymalny czas działania sekwencji zadań.

Type: Int64
Parameter Sets: (All)
Aliases: Duration

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewName

Określa nową nazwę sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Zwraca bieżący obiekt roboczy. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgramName

Określa nazwę programu uruchamianego z pakietu Menedżer konfiguracji określonego przez parametr DeploymentPackageId.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemoveSupportedOperatingSystemPlatform

Usuwa obsługiwany obiekt platformy systemu operacyjnego z sekwencji zadań. Aby uzyskać obsługiwany obiekt platformy systemu operacyjnego, użyj polecenia cmdlet Get-CMSupportedPlatform.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveSupportedOperatingSystemPlatforms

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunAnotherProgram

Wskazuje, czy uruchomić inny program przed uruchomieniem sekwencji zadań. Określ program przy użyciu parametru DeploymentPackageId i parametru ProgramName.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunEveryTime

Wskazuje, czy program określony w parametrze ProgramName jest uruchamiany za każdym razem, gdy sekwencja zadań jest uruchamiana. Jeśli określisz wartość $False, program nie zostanie uruchomiony, jeśli w przeszłości został pomyślnie uruchomiony.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunOnAnyPlatform

Wskazuje, że sekwencja zadań jest uruchamiana na dowolnej platformie systemu operacyjnego.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSupportedOperatingSystemPlatforms

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressNotification

Wskazuje, czy powiadomienia dla tej sekwencji zadań mają być pomijane.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TaskSequenceId

Określa identyfikator sekwencji zadań.

Type: String
Parameter Sets: SetById
Aliases: Id, TaskSequencePackageId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TaskSequenceName

Określa nazwę sekwencji zadań.

Type: String
Parameter Sets: SetByName
Aliases: Name

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseBootImage

Wskazuje, czy sekwencja zadań używa obrazu rozruchowego określonego za pomocą parametru BootImageID.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultText

Wskazuje, czy używać tekstu domyślnego w oknie dialogowym powiadomienia o postępie podczas pracy sekwencji zadań. W przypadku wybrania wartości parametru $False tego parametru należy określić tekst niestandardowy przy użyciu parametru CustomText.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

UWAGI

New-CMTaskSequence Get-CMTaskSequence Copy-CMTaskSequence Import-CMTaskSequence Export-CMTaskSequence Remove-CMTaskSequence Get-CMSupportedPlatform