New-CMSoftwareUpdatePhase

Utilize este cmdlet para criar uma fase de implementação para a atualização de software.

Sintaxe

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para criar uma fase de implementação para a atualização de software.

Exemplos

Exemplo 1: Criar uma fase de atualização de software

Este exemplo cria uma fase de atualização de software denominada MySUPhase para a coleção denominada MyCollection que só será apresentada no Centro de Software.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

Parâmetros

-AlertDelta

Este parâmetro é o mesmo que a seguinte definição na página Alertas do Assistente para Adicionar Fase na consola do : Desvio da hora limite. Especifique um valor inteiro para o desvio e, em seguida, especifique o tipo de período com o parâmetro AlertUnit .

Para definir este valor, tem de utilizar o parâmetro EnableAlert .

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AlertThresholdPercentage

Este parâmetro é o mesmo que a seguinte definição na página Alertas do Assistente para Adicionar Fase na consola do : A conformidade do cliente está abaixo do seguinte (percentagem). Especifique um valor inteiro para a percentagem. Para definir este valor, tem de utilizar o parâmetro EnableAlert .

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AlertUnit

Especifique o tipo de ponto final. Utilize este parâmetro com AlertDelta.

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowMeteredConnection

Este parâmetro é o mesmo que a seguinte definição na página Definições de Transferência do Assistente para Adicionar Fase na consola do : Permitir que os clientes numa ligação à Internet com tráfego limitado transfiram conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowSystemRestart

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente para Adicionar Fase na consola: Reinício do sistema (se necessário para concluir a instalação). Esta definição aplica-se quando o prazo de instalação é atingido, para permitir que esta atividade seja efetuada fora da janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowWumuFallback

Este parâmetro é o mesmo que a seguinte definição na página Definições de Transferência do Assistente para Adicionar Fase na consola do : se as atualizações de software não estiverem disponíveis no ponto de distribuição nos grupos de limites atuais, vizinhos ou de sites, transfira conteúdos a partir do Microsoft Updates.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BeginCondition

Especifique uma opção para iniciar esta fase de implementação após o êxito da fase anterior:

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : Iniciar automaticamente esta fase após um período de diferimento (em dias). Se especificar este valor, utilize DaysAfterPreviousPhaseSuccess para configurar o período de tempo.

  • Manually: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : Iniciar manualmente esta fase de implementação.

Tipo:BeginConditionType
Valores aceitos:AfterPeriod, Manually
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Collection

Especifique um objeto para a coleção de destino.

Tipo:IResultObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique a coleção de destino por ID.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifique a coleção de destino por nome.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
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

-CriteriaOption

Especifique uma opção para escolher os critérios de êxito da fase anterior:

  • Compliance: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola: Percentagem de êxito da implementação. Especifique o valor de percentagem com o parâmetro CriteriaValue .

  • Number: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola: Número de dispositivos implementados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue .

Tipo:CriteriaType
Valores aceitos:Compliance, Number
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CriteriaValue

Este valor inteiro depende do valor que especificar para CriteriaOption:

  • Compliance: especifique a percentagem

  • Number: especifique o número de dispositivos

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DaysAfterPreviousPhaseSuccess

Especifique um valor inteiro para o número de dias após o êxito da fase anterior para iniciar esta fase. Este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : Iniciar automaticamente esta fase após um período de diferimento (em dias).

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineUnit

Especifique o tipo de período de prazo. Utilize este parâmetro com DeadlineValue.

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstallationChoice .

Especifique um valor inteiro para o período de tempo do prazo. Utilize o parâmetro DeadlineUnit para especificar o tipo de período: Hours, Days, , Weeks. Months Este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : a instalação é necessária após este período de tempo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableScomAlert

Este parâmetro é o mesmo que a seguinte definição na página Alertas do Assistente para Adicionar Fase na consola do : Desativar alertas do Operations Manager enquanto as atualizações de software são executadas.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. 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

-EnableAlert

Este parâmetro é o mesmo que a seguinte definição na página Alertas do Assistente para Adicionar Fase na consola do : Gerar um alerta quando as seguintes condições forem cumpridas. Quando definir este parâmetro como $true, defina também os seguintes parâmetros:

  • AlertThresholdPercentage
  • AlertDelta
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableWakeOnLan

Este parâmetro é o mesmo que a seguinte definição na página Definições de Implementação do Assistente para Adicionar Fase na consola do : Utilizar a Reativação por LAN para reativar os clientes para as implementações necessárias.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado. Não é recomendado. 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

-GenerateScomAlertOnFailure

Este parâmetro é o mesmo que a seguinte definição na página Alertas do Assistente para Adicionar Fase na consola do : Gerar alerta do Operations Manager quando uma instalação de atualização de software falha.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstallationChoice

Especifique uma opção para o comportamento relativo ao momento em que o software é disponibilizado:

  • AsSoonAsPossible: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : a instalação é necessária o mais rapidamente possível.

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : a instalação é necessária após este período de tempo. Se especificar este valor, utilize DeadlineUnit e DeadlineValue para configurar o período de tempo.

Tipo:InstallationChoiceType
Valores aceitos:AsSoonAsPossible, AfterPeriod
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PhaseDescription

Especifique uma descrição para a fase.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PhaseName

Especifique um nome para a descrição.

Tipo:String
Aliases:Name
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RequirePostRebootFullScan

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente para Adicionar Fase na consola do : se alguma atualização nesta implementação exigir um reinício do sistema, execute o ciclo de avaliação de implementação de atualizações após o reinício.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerRestartSuppression

Este parâmetro é o mesmo que a seguinte definição na página Experiência de Utilizador do Assistente para Adicionar Fase na consola do . Suprimir o reinício do sistema nos seguintes dispositivos: Servidores.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareInstallation

Este parâmetro é o mesmo que a seguinte definição na página Experiência de Utilizador do Assistente para Adicionar Fase na consola: Instalação de Software. Esta definição aplica-se quando o prazo de instalação é atingido, para permitir que esta atividade seja efetuada fora da janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StateMessageVerbosity

Este parâmetro é o mesmo que a seguinte definição na página Definições de Implementação do Assistente para Adicionar Fase na consola do : Nível de detalhe da mensagem de estado com os seguintes valores:

  • AllMessages: Todas as mensagens
  • OnlySuccessAndErrorMessages: apenas mensagens de êxito e de erro
  • OnlyErrorMessages: apenas mensagens de erro
Tipo:VerbosityLevelType
Valores aceitos:AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ThrottlingDays

Especifique um valor inteiro para o número de dias para disponibilizar gradualmente este software. Este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : disponibilizar gradualmente este software ao longo deste período de tempo (em dias).

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseNeighborDP

Este parâmetro é o mesmo que a seguinte definição na página Definições de Transferência do Assistente para Adicionar Fase na consola do : selecione a opção de implementação a utilizar quando um cliente utiliza um ponto de distribuição de um grupo de limites de vizinhos ou do grupo de limites de site predefinido. Especifique os seguintes valores:

  • $true: transferir atualizações de software a partir do ponto de distribuição e instalar
  • $false: Não instalar atualizações de software
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserNotificationOption

Este parâmetro é o mesmo que a seguinte definição na página Experiência de Utilizador do Assistente para Adicionar Fase na consola do : Especificar a definição de experiência de utilizador para esta implementação com os seguintes valores:

  • DisplayAll: apresentar no Centro de Software e mostrar todas as notificações
  • DisplaySoftwareCenterOnly: apresentar no Centro de Software e mostrar apenas notificações para reinícios do computador
  • HideAll: Ocultar no Centro de Software e em todas as notificações
Tipo:UserNotificationType
Valores aceitos:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseSiteDefaultDP

Este parâmetro é o mesmo que a seguinte definição na página Definições de Transferência do Assistente para Adicionar Fase na consola do : quando as atualizações de software não estão disponíveis em quaisquer pontos de distribuição no grupo de limites atual ou vizinho, o cliente pode transferir e instalar atualizações de software a partir de pontos de distribuição no grupo de limites predefinido do site. Especifique os seguintes valores:

  • $true: Transfira e instale atualizações de software a partir dos pontos de distribuição no grupo de limites predefinido do site
  • $false: Não instalar atualizações de software
Tipo:Boolean
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

-WorkstationRestartSuppression

Este parâmetro é o mesmo que a seguinte definição na página Experiência de Utilizador do Assistente para Adicionar Fase na consola do . Suprima o reinício do sistema nos seguintes dispositivos: Estações de Trabalho.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WriteFilterCommit

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente para Adicionar Fase na consola do : Consolidar alterações dentro do prazo ou durante uma janela de manutenção (requer reinício). Esta definição aplica-se ao processamento de filtros de escrita para dispositivos Windows Embedded.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase