New-CMTSStepUpgradeOperatingSystem

SYNOPSIS

Maak een stap besturingssysteem upgraden, die u aan een takenreeks kunt toevoegen.

SYNTAX

New-CMTSStepUpgradeOperatingSystem [-DriverPackage <IResultObject>]
 [-DynamicUpdateSetting <DynamicUpdateOption>] [-EditionIndex <Int32>] [-IgnoreMessage <Boolean>]
 [-ProductKey <String>] [-ScanOnly <Boolean>] [-SetupTimeout <Int32>] [-SourcePath <String>]
 [-StagedContent <String>] [-UpgradePackage <IResultObject>] [-SoftwareUpdate <IResultObject[]>]
 [-Condition <IResultObject[]>] [-ContinueOnError] [-Description <String>] [-Disable] -Name <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Met deze cmdlet maakt u een nieuw stapobject besturingssysteem upgraden. Gebruik vervolgens de cmdlet Add-CMTaskSequenceStep om de stap toe te voegen aan een takenreeks. Zie Over takenreeksstappen: Besturingssysteem upgraden voor meer informatie over deze stap.

Notitie

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

EXAMPLES

Voorbeeld 1

In dit voorbeeld wordt eerst de cmdlet Get-CMOperatingSystemInstaller gebruikt om een -object op te halen voor het upgradepakket van het besturingssysteem. Dit object wordt op de $osUpgPkg op slaat. In de volgende stap maakt u een -object voor de stap Besturingssysteem upgraden, met behulp van het $osUpgPkg-object als het upgradepakket van het besturingssysteem.

Vervolgens wordt een takenreeksobject gemaakt en wordt deze nieuwe stap toegevoegd aan de takenreeks op index 11.

$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1

$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsUpg | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

PARAMETERS

-Voorwaarde

Geef een voorwaardeobject op dat met deze stap moet worden gebruikt. Gebruik een van de cmdlets voor takenreeksvoorwaarde om dit object op te halen. Bijvoorbeeld Get-CMTSStepConditionVariable.

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

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: None
Accept pipeline input: False
Accept wildcard characters: False

-ContinueOnError

Voeg deze parameter toe om de stapoptie Doorgaan bij fout in teschakelen. Wanneer u deze optie inschakelen als de stap mislukt, wordt de takenreeks voortgezet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Beschrijving

Geef een optionele beschrijving op voor deze takenreeksstap.

Type: String
Parameter Sets: (All)
Aliases:

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

-Uitschakelen

Voeg deze parameter toe om deze takenreeksstap uit te schakelen.

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

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

-DriverPackage

Geef een stuurprogrammapakketobject op om de inhoud van het stuurprogramma op te geven Windows setup tijdens de upgrade. Gebruik de cmdlet Get-CMDriverPackage om dit pakket op te halen.

Gebruik de parameter StagedContent om de locatie voor de inhoud van het stuurprogramma op te geven.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-DynamicUpdateSetting

Gebruik deze parameter om setup dynamisch bij te Windows met Windows Update.

• DisablePolicy: Gebruik dynamische updates niet
• UsingPolicy: Schakel setup in voor het gebruik van dynamische updates, zoals zoeken, downloaden en installeren van updates.
• OverridePolicy: Het lokale beleid tijdelijk in realtime overschrijven om dynamische updatebewerkingen uit te voeren. De computer ontvangt updates van Windows Update.

Type: DynamicUpdateOption
Parameter Sets: (All)
Aliases:
Accepted values: DisablePolicy, UsingPolicy, OverridePolicy

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

-EditionIndex

Geef een geheel getal op van de editie van het besturingssysteemupgradepakket. Gebruik deze parameter met de parameter UpgradePackage.

Type: Int32
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

-IgnoreMessage

Stel deze parameter in op om op te geven Windows Installatie de installatie voltooit, waarbij eventuele $true compatibiliteitsberichten die kunnen worden genegeerd, worden genegeerd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Geef een naam op voor deze stap om deze in de takenreeks te identificeren.

Type: String
Parameter Sets: (All)
Aliases: StepName

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

-ProductKey

Geef de productcode op die moet worden toegepast op het upgradeproces.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScanOnly

Stel deze parameter in op $true om de compatibiliteitsscan Windows setup uit te voeren zonder de upgrade te starten.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SetupTimeout

Geef het aantal minuten op voordat Configuration Manager stap mislukt. Deze optie is handig als Windows setup stopt met verwerken, maar niet wordt beëindigd.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-SourcePath

Geef een lokaal of netwerkpad op naar de Windows media die Windows Setup gebruikt.

Type: String
Parameter Sets: (All)
Aliases:

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

-StagedContent

Gebruik deze parameter met DriverPackage om de locatie voor de stuurprogramma-inhoud op te geven. U kunt een lokale map, netwerkpad of een takenreeksvariabele opgeven.

Type: String
Parameter Sets: (All)
Aliases:

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

-UpgradePackage

Geef een upgradepakketobject voor het besturingssysteem op. Gebruik de parameter EditionIndex om de editie in te stellen.

Gebruik de cmdlet Get-CMOperatingSystemInstaller om dit object op te halen.

Type: IResultObject
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: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftwareUpdate

Vanaf versie 2107 geeft u een software-updateobject op om het besturingssysteem van een client Windows bijwerken met behulp van een functie-update. Gebruik de cmdlet Get-CMSoftwareUpdate om dit object op te halen.

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

Required: False
Position: Named
Default value: None
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

Geen

OUTPUTS

IResultObject#SMS_TaskSequence_UpgradeOperatingSystemAction

OPMERKINGEN

Zie WMI-klasse SMS_TaskSequence_UpgradeOperatingSystemAction server voor meer informatie over dit retourobject en deeigenschappen ervan.

RELATED LINKS

Get-CMTSStepUpgradeOperatingSystem Remove-CMTSStepUpgradeOperatingSystem Set-CMTSStepUpgradeOperatingSystem

Over takenreeksstappen: Besturingssysteem upgraden