New-CMTSStepUpgradeOperatingSystem
Crie uma etapa atualizar o sistema operacional , que você pode adicionar a uma sequência de tarefas.
Sintaxe
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 etapa do sistema operacional de atualização . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, confira Sobre as etapas da sequência de tarefas: Atualizar o sistema operacional.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1
Este exemplo usa primeiro o cmdlet Get-CMOperatingSystemInstaller para obter um objeto para o pacote de atualização do sistema operacional. Ele salva esse objeto na variável $osUpgPkg . A próxima etapa cria um objeto para a etapa atualizar o sistema operacional , usando o objeto $osUpgPkg como o pacote de atualização do sistema operacional.
Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas 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
Parâmetros
-Condition
Especifique um objeto de condição a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Tipo: | IResultObject[] |
Aliases: | Conditions |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ContinueOnError
Adicione esse parâmetro para habilitar a opção de etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Description
Especifique uma descrição opcional para esta etapa de sequência de tarefas.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Disable
Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.
Tipo: | SwitchParameter |
Aliases: | DisableThisStep |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DriverPackage
Especifique um objeto de pacote de driver para fornecer seu conteúdo de driver à Configuração do Windows durante a atualização. Para obter esse pacote, use o cmdlet Get-CMDriverPackage .
Use o parâmetro StagedContent para especificar o local do conteúdo do driver.
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DynamicUpdateSetting
Use esse parâmetro para atualizar dinamicamente a Instalação do Windows com Windows Update.
-
DisablePolicy
: não use Atualização Dinâmica -
UsingPolicy
: habilitar a instalação para usar o Dynamic Update, como pesquisar, baixar 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 de Windows Update.
Tipo: | DynamicUpdateOption |
Valores aceitos: | DisablePolicy, UsingPolicy, OverridePolicy |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-EditionIndex
Especifique um valor inteiro da edição do pacote de atualização do sistema operacional. Use esse parâmetro com o parâmetro UpgradePackage .
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IgnoreMessage
Defina esse parâmetro para $true
especificar que a Instalação do Windows conclua a instalação, ignorando quaisquer mensagens de compatibilidade dispensáveis.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.
Tipo: | String |
Aliases: | StepName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProductKey
Especifique a chave do produto a ser aplicada ao processo de atualização.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ScanOnly
Defina esse parâmetro para $true
executar a verificação de compatibilidade da Configuração do Windows sem iniciar a atualização.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SetupTimeout
Especifique o número de minutos antes de Configuration Manager falhar nesta etapa. Essa opção será útil se a Instalação do Windows parar de processar, mas não terminar.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SoftwareUpdate
A partir da versão 2107, especifique um objeto de atualização de software para atualizar o sistema operacional Windows de um cliente usando uma atualização de recurso. Para obter esse objeto, use o cmdlet Get-CMSoftwareUpdate .
Tipo: | IResultObject[] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-SourcePath
Especifique um caminho local ou de rede para a mídia do Windows que a Configuração do Windows usa.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-StagedContent
Use esse parâmetro com DriverPackage para especificar o local do conteúdo do driver. Você pode especificar uma pasta local, um caminho de rede ou uma variável de sequência de tarefas.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-UpgradePackage
Especifique um objeto de pacote de atualização do sistema operacional. Use o parâmetro EditionIndex para definir a edição.
Para obter esse objeto, use o cmdlet Get-CMOperatingSystemInstaller .
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_UpgradeOperatingSystemAction classe WMI do servidor.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de