New-CMTSStepUpgradeOperatingSystem

SYNOPSIS

Skapa ett uppgraderingssteg för operativsystemet som du kan lägga till i en aktivitetssekvens.

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

Den här cmdleten skapar ett nytt uppgraderingsoperativsystemsobjekt. Använd sedan cmdleten Add-CMTaskSequenceStep för att lägga till steget i en aktivitetssekvens. Mer information om det här steget finns i Om aktivitetssekvenssteg: Uppgradera OS.

Anteckning

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

EXAMPLES

Exempel 1

I det här exemplet används först cmdleten Get-CMOperatingSystemInstaller för att hämta ett objekt för OS-uppgraderingspaketet. Det här objektet sparas i $osUpgPkg variabeln. Nästa steg skapar ett -objekt för steget Uppgradera operativsystem, med hjälp $osUpgPkg som OS-uppgraderingspaket.

Den hämtar sedan ett aktivitetssekvensobjekt och lägger till det här nya steget i aktivitetssekvensen vid 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

-Condition

Ange ett villkorsobjekt som ska användas med det här steget. Hämta det här objektet genom att använda en av cmdletarna för aktivitetssekvensvillkor. Till exempel 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

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

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

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

-ContinueOnError

Lägg till den här parametern för att aktivera stegalternativet Fortsätt vid fel. Om steget misslyckas när du aktiverar det här alternativet fortsätter aktivitetssekvensen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Ange en valfri beskrivning för det här aktivitetssekvenssteget.

Type: String
Parameter Sets: (All)
Aliases:

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

-Inaktivera

Lägg till den här parametern för att inaktivera det här aktivitetssekvenssteget.

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

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

-DriverPackage

Ange ett drivrutinspaketobjekt för att tillhandahålla drivrutinsinnehåll för att Windows installationsprogrammet under uppgraderingen. Hämta det här paketet med hjälp av cmdleten Get-CMDriverPackage.

Använd parametern StagedContent för att ange platsen för drivrutinsinnehållet.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-DynamicUpdateSetting

Använd den här parametern för att dynamiskt uppdatera Windows installationsprogrammet med Windows Update.

• DisablePolicy: Använd inte dynamisk uppdatering
• UsingPolicy: Aktivera installationsprogrammet för att använda dynamisk uppdatering, till exempel söka efter, ladda ned och installera uppdateringar.
• OverridePolicy: Åsidosätt tillfälligt den lokala principen i realtid för att köra åtgärder för dynamisk uppdatering. Datorn hämtar uppdateringar från 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

Ange ett heltalsvärde för versionen av OS-uppgraderingspaketet. Använd den här parametern med parametern UpgradePackage.

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

-IgnoreMessage

Ange den här $true parametern till för att Windows installationsprogrammet slutför installationen och ignorera eventuella kompatibilitetsmeddelanden som kan avfärdas.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Ange ett namn för det här steget för att identifiera det i aktivitetssekvensen.

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

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

-ProductKey

Ange produktnyckeln som ska gälla för uppgraderingsprocessen.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScanOnly

Ange den här $true parametern till för att Windows kompatibilitetsgenomsökning för installation utan att starta uppgraderingen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SetupTimeout

Ange antalet minuter innan åtgärden Konfigurationshanteraren det här steget. Det här alternativet är användbart Windows installationen slutar bearbetas men inte avslutas.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-SourcePath

Ange en lokal sökväg eller nätverkssökväg till Windows media som Windows installationsprogrammet använder.

Type: String
Parameter Sets: (All)
Aliases:

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

-StagedContent

Använd den här parametern med DriverPackage för att ange platsen för drivrutinsinnehållet. Du kan ange en lokal mapp, en nätverkssökväg eller en aktivitetssekvensvariabel.

Type: String
Parameter Sets: (All)
Aliases:

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

-UpgradePackage

Ange ett objekt för os-uppgraderingspaket. Använd parametern EditionIndex för att ange utgåvan.

Hämta det här objektet med cmdleten Get-CMOperatingSystemInstaller.

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

-SoftwareUpdate

Från och med version 2107 anger du ett programuppdateringsobjekt för att uppgradera en klients operativsystem Windows med hjälp av en funktionsuppdatering. Hämta det här objektet med hjälp av cmdleten Get-CMSoftwareUpdate.

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

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

Ingen

OUTPUTS

IResultObject#SMS_TaskSequence_UpgradeOperatingSystemAction

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_TaskSequence_UpgradeOperatingSystemAction serverns WMI-klass.

RELATED LINKS

Get-CMTSStepUpgradeOperatingSystem Remove-CMTSStepUpgradeOperatingSystem Set-CMTSStepUpgradeOperatingSystem

Om aktivitetssekvenssteg: Uppgradera operativsystemet