Set-CMTaskSequence

SYNOPSIS

Hiermee stelt Configuration Manager takenreeks in.

SYNTAX

SetByValue (standaard)

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

De cmdlet Set-CMTaskSequence wijzigt een Configuration Manager takenreeks.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een takenreeks op halen en de naam ervan wijzigen

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

De eerste opdracht haalt het takenreeksobject met de naam TaskSequence01 op en slaat het object op in de $TaskSequence variabele.

Met de tweede opdracht wordt de naam van de takenreeks die is opgeslagen in $TaskSequence gewijzigd in NewTS01.

Voorbeeld 2: Een takenreeks doorgeven en de naam ervan wijzigen

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

Met deze opdracht haalt u het takenreeksobject taskSequence02 op en gebruikt u de pijplijnoperator om het object door te geven aan Set-CMTaskSequence, waarmee de naam van het takenreeksobject wordt gewijzigd in NewTS02.

PARAMETERS

-AddSupportedOperatingSystemPlatform

Voegt een ondersteund besturingssysteemplatformobject toe aan de takenreeks. Gebruik de cmdlet Get-CMSupportedPlatform om een ondersteund besturingssysteemplatformobject te verkrijgen.

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

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

-BootImageId

Hiermee geeft u de id van een opstartafbeelding.

Type: String
Parameter Sets: (All)
Aliases:

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

-Categorie

Hiermee geeft u een categorie voor de takenreeks op. U kunt categorieën gebruiken om takenreeksen te groepen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-CustomText

Hiermee geeft u aangepaste tekst voor de takenreeks op. Aangepaste tekst wordt weergegeven in het dialoogvenster Voortgangsmelding terwijl de takenreeks wordt uitgevoerd.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeploymentPackageId

Hiermee geeft u de id van een pakket. Als u een waarde van $True parameter RunAnotherProgram opgeeft, wordt het opgegeven pakket uitgevoerd voordat de takenreeks wordt uitgevoerd.

Type: String
Parameter Sets: (All)
Aliases:

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

-Beschrijving

Hiermee geeft u een beschrijving voor de takenreeks.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableTaskSequence

Geeft aan of deze takenreeks moet worden uitgeschakeld.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableNotification

Geeft aan of meldingen voor deze takenreeks moeten worden ingeschakeld.

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

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

-EnableTaskSequence

Geeft aan of deze takenreeks moet worden ingeschakeld.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-HighPerformance

Vanaf versie 1910 gebruikt u deze parameter om de volgende optie in te stellen op de pagina Prestaties van de takenreekseigenschappen: Uitvoeren als energieplan voor hoge prestaties.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InputObject

Hiermee geeft u een takenreeksobject op. Als u een takenreeksobject wilt verkrijgen, gebruikt u de 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

Hiermee geeft u in minuten de maximale tijd voor de takenreeks.

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

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

-NewName

Hiermee geeft u een nieuwe naam voor de takenreeks.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Retourneert het huidige werkende object. Deze cmdlet genereert standaard geen uitvoer.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgramName

Hiermee geeft u de naam op van een programma dat moet worden uitgevoerd vanuit Configuration Manager softwarepakket dat is opgegeven door de parameter DeploymentPackageId.

Type: String
Parameter Sets: (All)
Aliases:

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

-RemoveSupportedOperatingSystemPlatform

Hiermee verwijdert u een ondersteund besturingssysteemplatformobject uit de takenreeks. Gebruik de cmdlet Get-CMSupportedPlatform om een ondersteund besturingssysteemplatformobject te verkrijgen.

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

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

-RunAnotherProgram

Geeft aan of een ander programma moet worden uitgevoerd voordat de takenreeks wordt uitgevoerd. Geef het programma op met behulp van de parameter DeploymentPackageId en de parameter ProgramName.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RunEveryTime

Geeft aan of het programma dat is opgegeven in de ProgramName parameter wordt uitgevoerd telkens als de takenreeks wordt uitgevoerd. Als u een waarde opgeeft van $False, wordt het programma niet uitgevoerd als het in het verleden succesvol is uitgevoerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RunOnAnyPlatform

Geeft aan dat de takenreeks wordt uitgevoerd op elk besturingssysteemplatform.

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

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

-SuppressNotification

Geeft aan of meldingen voor deze takenreeks moeten worden onderdrukt.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-TaskSequenceId

Hiermee geeft u de id van een takenreeks.

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

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

-TaskSequenceName

Hiermee geeft u de naam van een takenreeks.

Type: String
Parameter Sets: SetByName
Aliases: Name

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

-UseBootImage

Geeft aan of de takenreeks de opstartafbeelding gebruikt die is opgegeven met behulp van de parameter BootImageID.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseDefaultText

Geeft aan of standaardtekst moet worden gebruikt in het dialoogvenster voor voortgangsmeldingen terwijl de takenreeks wordt uitgevoerd. Als u een waarde van $False parameter selecteert, moet u aangepaste tekst opgeven met behulp van de parameter CustomText.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

RELATED LINKS

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