Dela via


Set-CMTaskSequence

SYNOPSIS

Anger en Konfigurationshanteraren aktivitetssekvens.

SYNTAX

SetByValue (standard)

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

Cmdleten Set-CMTaskSequence ändrar en Konfigurationshanteraren aktivitetssekvens.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta en aktivitetssekvens och ändra dess namn

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

Det första kommandot hämtar aktivitetssekvensobjektet med namnet TaskSequence01 och lagrar objektet i $TaskSequence variabeln.

Det andra kommandot ändrar namnet på aktivitetssekvensen som lagras i $TaskSequence till NewTS01.

Exempel 2: Skicka en aktivitetssekvens och ändra dess namn

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

Det här kommandot hämtar aktivitetssekvensobjektet med namnet TaskSequence02 och använder pipelineoperatorn för att skicka objektet till Set-CMTaskSequence, vilket ändrar namnet på aktivitetssekvensobjektet till NewTS02.

PARAMETERS

-AddSupportedOperatingSystemPlatform

Lägger till ett operativsystemplattformsobjekt som stöds i aktivitetssekvensen. Om du vill hämta ett operativsystemplattformsobjekt som stöds använder du cmdleten 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

Anger ID för en startavbildning.

Type: String
Parameter Sets: (All)
Aliases:

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

-Kategori

Anger en kategori för aktivitetssekvensen. Du kan använda kategorier för att gruppera aktivitetssekvenser.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-CustomText

Anger anpassad text för aktivitetssekvensen. Anpassad text visas i dialogrutan förloppsmeddelande medan aktivitetssekvensen körs.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeploymentPackageId

Anger ID för ett paket. Om du anger värdet $True för parametern RunAnotherProgram körs det angivna paketet innan aktivitetssekvensen körs.

Type: String
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Anger en beskrivning av aktivitetssekvensen.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableTaskSequence

Anger om du vill inaktivera den här aktivitetssekvensen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableNotification

Anger om du vill aktivera meddelanden för den här aktivitetssekvensen.

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

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

-EnableTaskSequence

Anger om du vill aktivera den här aktivitetssekvensen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-HighPerformance

Från och med version 1910 använder du den här parametern för att ange följande alternativ på sidan Prestanda för aktivitetssekvensegenskaperna: Kör som energischema med höga prestanda.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InputObject

Anger ett aktivitetssekvensobjekt. Om du vill hämta ett aktivitetssekvensobjekt använder du cmdleten 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

Anger den maximala körtiden för aktivitetssekvensen i minuter.

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

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

-NewName

Anger ett nytt namn för aktivitetssekvensen.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Returnerar det aktuella arbetsobjektet. Som standard genererar denna cmdlet inga utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgramName

Anger namnet på ett program som ska köras från ett Konfigurationshanteraren programpaket som anges av parametern DeploymentPackageId.

Type: String
Parameter Sets: (All)
Aliases:

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

-RemoveSupportedOperatingSystemPlatform

Tar bort ett operativsystemplattformsobjekt som stöds från aktivitetssekvensen. Om du vill hämta ett operativsystemplattformsobjekt som stöds använder du cmdleten 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

Anger om du vill köra ett annat program innan du kör aktivitetssekvensen. Ange programmet med hjälp av parametern DeploymentPackageId och parametern ProgramName.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RunEveryTime

Anger om programmet som anges i parametern ProgramName körs varje gång aktivitetssekvensen körs. Om du anger värdet $False körs inte programmet om det har körts tidigare.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RunOnAnyPlatform

Anger att aktivitetssekvensen körs på valfri operativsystemplattform.

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

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

-SuppressNotification

Anger om meddelanden för den här aktivitetssekvensen ska ignoreras.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-TaskSequenceId

Anger ID för en aktivitetssekvens.

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

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

-TaskSequenceName

Anger namnet på en aktivitetssekvens.

Type: String
Parameter Sets: SetByName
Aliases: Name

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

-UseBootImage

Anger om aktivitetssekvensen använder den startavbildning som anges med hjälp av parametern BootImageID.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseDefaultText

Anger om standardtexten ska användas i förloppsmeddelandedialogrutan medan aktivitetssekvensen körs. Om du väljer värdet för $False för den här parametern måste du ange anpassad text med hjälp av parametern CustomText.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

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