New-CMTSStepUpgradeOperatingSystem

SYNOPSIS

Utwórz krok Uaktualnij system operacyjny, który można dodać do sekwencji zadań.

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

To polecenie cmdlet tworzy nowy obiekt kroku uaktualniania systemu operacyjnego. Następnie użyj polecenia cmdlet Add-CMTaskSequenceStep, aby dodać krok do sekwencji zadań. Aby uzyskać więcej informacji na temat tego kroku, zobacz Informacje o krokach sekwencji zadań: Uaktualnianie systemu operacyjnego.

Uwaga

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

EXAMPLES

Przykład 1

W tym przykładzie najpierw użyto polecenia cmdlet Get-CMOperatingSystemInstaller w celu uzyskania obiektu pakietu uaktualnienia systemu operacyjnego. Zapisuje ten obiekt w $osUpgPkg zmiennej . Następny krok powoduje utworzenie obiektu dla kroku Uaktualnianie systemu operacyjnego przy użyciu obiektu $osUpgPkg jako pakietu uaktualnienia systemu operacyjnego.

Następnie pobiera obiekt sekwencji zadań i dodaje ten nowy krok do sekwencji zadań pod indeksem 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

-Warunek

Określ obiekt warunku do użycia w tym kroku. Aby uzyskać ten obiekt, użyj jednego z polecenia cmdlet warunku sekwencji zadań. Na przykład 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

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-ContinueOnError

Dodaj ten parametr, aby włączyć opcję kroku Kontynuuj przy błędzie. Jeśli ta opcja zostanie włączyć, jeśli krok zakończy się niepowodzeniem, sekwencja zadań będzie kontynuowana.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Description (Opis)

Określ opcjonalny opis tego kroku sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-Wyłącz

Dodaj ten parametr, aby wyłączyć ten krok sekwencji zadań.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. 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

-DriverPackage

Określ obiekt pakietu sterowników, aby udostępnić jego zawartość sterowników Windows instalacji podczas uaktualniania. Aby uzyskać ten pakiet, użyj polecenia cmdlet Get-CMDriverPackage.

Użyj parametru StagedContent, aby określić lokalizację zawartości sterownika.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-DynamicUpdateSetting

Użyj tego parametru, aby dynamicznie aktualizować Windows przy użyciu Windows Update.

• DisablePolicy: nie używaj aktualizacji dynamicznej
• UsingPolicy: włącz instalatora, aby używać aktualizacji dynamicznej, takich jak wyszukiwanie, pobieranie i instalowanie aktualizacji.
• OverridePolicy: tymczasowe zastąpienie zasad lokalnych w czasie rzeczywistym w celu uruchomienia operacji aktualizacji dynamicznych. Komputer pobiera aktualizacje z 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

Określ wartość całkowitą wersji pakietu uaktualnienia systemu operacyjnego. Użyj tego parametru z parametrem UpgradePackage.

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

-IgnoreMessage

Ustaw ten parametr na , aby określić, Windows instalator ukończy instalację, ignorując wszystkie komunikaty o zgodności, które $true można odrzucić.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Określ nazwę tego kroku, aby zidentyfikować ją w sekwencji zadań.

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

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

-ProductKey (Klucz produktu)

Określ klucz produktu do zastosowania w procesie uaktualniania.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScanOnly

Ustaw ten parametr na $true , aby uruchomić skanowanie zgodności Windows instalacji bez rozpoczynania uaktualniania.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SetupTimeout

Określ liczbę minut, po których Menedżer konfiguracji ten krok zakończy się niepowodzeniem. Ta opcja jest przydatna, jeśli Windows zatrzymuje przetwarzanie, ale nie kończy pracy.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-SourcePath

Określ ścieżkę lokalną lub sieciową do nośnika Windows używanego Windows instalacji.

Type: String
Parameter Sets: (All)
Aliases:

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

-StagedContent

Użyj tego parametru z DriverPackage, aby określić lokalizację zawartości sterownika. Możesz wybrać folder lokalny, ścieżkę sieciową lub zmienną sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-UpgradePackage

Określ obiekt pakietu uaktualnienia systemu operacyjnego. Użyj parametru EditionIndex, aby ustawić wersję.

Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMOperatingSystemInstaller.

Type: IResultObject
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 jest uruchamiane.

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

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

-SoftwareUpdate

Począwszy od wersji 2107, określ obiekt aktualizacji oprogramowania w celu uaktualnienia systemu Windows operacyjnego klienta przy użyciu aktualizacji funkcji. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMSoftwareUpdate.

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

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

Brak

OUTPUTS

IResultObject#SMS_TaskSequence_UpgradeOperatingSystemAction

UWAGI

Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_TaskSequence_UpgradeOperatingSystemAction klasy WMI serwera.

RELATED LINKS

Get-CMTSStepUpgradeOperatingSystem Remove-CMTSStepUpgradeOperatingSystem Set-CMTSStepUpgradeOperatingSystem

Informacje o krokach sekwencji zadań: Uaktualnianie systemu operacyjnego