New-CMTSStepUpgradeOperatingSystem

SYNOPSIS

Crie um passo de sistema operativo de atualização, que pode adicionar a uma sequência de tarefas.

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

Este cmdlet cria um novo objeto de passo de upgrade. Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, consulte sobre os passos da sequência de tarefas: Atualizar o SISTEMA.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1

Este exemplo utiliza primeiro o cmdlet Get-CMOperatingSystemInstaller para obter um objeto para o pacote de upgrade do SO. Salva este objeto na variável $osUpgPkg. O passo seguinte cria um objeto para o passo de upgrade do SO, utilizando o objeto $osUpgPkg como pacote de upgrade do SO.

Em seguida, obtém um objeto de sequência de tarefa, e adiciona este novo passo à sequência de tarefa no índice 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

-Condição

Especifique um objeto de condição para usar com este passo. Para obter este objeto, utilize um dos cmdlets da sequência de tarefa. Por exemplo, 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

Solicita a sua confirmação antes de executar o cmdlet.

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

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

-ContinueOnError

Adicione este parâmetro para ativar a opção de passo Continue a cometer erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continua.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Descrição

Especifique uma descrição opcional para este passo de sequência de tarefa.

Type: String
Parameter Sets: (All)
Aliases:

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

-Desativar

Adicione este parâmetro para desativar este passo de sequência de tarefa.

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

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DriverPackage

Especifique um objeto de pacote do controlador para fornecer o conteúdo do seu controlador para Windows Configuração durante a atualização. Para obter este pacote, utilize o cmdlet Get-CMDriverPackage.

Utilize o parâmetro StagedContent para especificar a localização do conteúdo do condutor.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-DynamicUpdateSetting

Utilize este parâmetro para atualizar dinamicamente Windows Configuração com Windows Update.

• DisablePolicy: Não utilize a Atualização Dinâmica
• UsingPolicy: Ative a configuração para utilizar o Dynamic Update, como pesquisar, descarregar e instalar atualizações.
• OverridePolicy: Substitua temporariamente a política local em tempo real para executar operações de Atualização Dinâmica. O computador recebe atualizações a partir de 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

- EdiçãoIndex

Especifique um valor inteiro da edição do pacote de upgrade do SO. Utilize este parâmetro com o parâmetro UpgradePackage.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Ignorar AMessage

Desa esta definição para $true especificar que Windows Configuração completa a instalação, ignorando quaisquer mensagens de compatibilidade dispensáveis.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Especifique um nome para este passo para identificá-lo na sequência de tarefa.

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

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

-ProductKey

Especifique a chave do produto para aplicar ao processo de atualização.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScanOnly

Desa esta definição deste parâmetro $true para executar a compatibilidade de configuração Windows sem iniciar a atualização.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SetupTimeout

Especifique o número de minutos antes de o Gestor de Configuração falhar este passo. Esta opção é útil se Windows Configuração parar de processar, mas não terminar.

Type: Int32
Parameter Sets: (All)
Aliases:

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

- SourcePath

Especifique um caminho local ou de rede para os meios de Windows que Windows a Configuração utiliza.

Type: String
Parameter Sets: (All)
Aliases:

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

-EncenarContent

Utilize este parâmetro com a DriverPackage para especificar a localização do conteúdo do condutor. Pode especificar uma pasta local, um caminho de rede ou uma variável de sequência de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

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

-UpgradePackage

Especifique um objeto de pacote de upgrade de SO. Utilize o parâmetro EditionIndex para definir a edição.

Para obter este objeto, utilize o cmdlet Get-CMOperatingSystemInstaller.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

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

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

-SoftwareUpdate

A partir da versão 2107, especifique um objeto de atualização de software para atualizar o sistema operativo Windows de um cliente utilizando uma atualização de funcionalidade. Para obter este objeto, utilize o cmdlet Get-CMSoftwareUpdate.

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

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject#SMS_TaskSequence_UpgradeOperatingSystemAction

NOTAS

Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_TaskSequence_UpgradeOperatingSystemAction classe WMI do servidor.

RELATED LINKS

Sistema operativo Get-CMTSStepUpgrade Remover-CMTSStepUpgrade Sistema operativo Sistema operativo Set-CMTSStepUpgrade

Sobre etapas de sequência de tarefas: Upgrade OS