New-CMSoftwareUpdatePhase

Módulo:

ConfigurationManager

Use este cmdlet para criar uma fase de implantação para atualização de software.

Syntax

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

Use este cmdlet para criar uma fase de implantação para 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 chamada MySUPhase para a coleção chamada MyCollection que será exibida apenas no Centro de Software.

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

Parâmetros

-AlertDelta

Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Fase de Adição no console: Deslocamento do tempo de prazo. Especifique um valor inteiro para o deslocamento e especifique o tipo de período com o parâmetro AlertUnit .

Para definir esse valor, você precisa usar o parâmetro EnableAlert .

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

-AlertThresholdPercentage

Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Fase de Adição no console: a conformidade do cliente está abaixo do seguinte (percentual). Especifique um valor inteiro para o percentual. Para definir esse valor, você precisa usar o parâmetro EnableAlert .

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

-AlertUnit

Especifique o tipo de período. Use esse parâmetro com AlertDelta.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowMeteredConnection

Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Download do Assistente de Fase de Adição no console: permitir que clientes em uma conexão de Internet limitada baixem conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.

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

-AllowSystemRestart

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Adicionar Fase no console: Reinicialização do sistema (se necessário para concluir a instalação). Essa configuração se aplica quando o prazo de instalação é atingido, para permitir que essa atividade seja executada fora da janela de manutenção.

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

-AllowWumuFallback

Esse parâmetro é o mesmo que a seguinte configuração na página Baixar Configurações do Assistente de Fase de Adição no console: se as atualizações de software não estiverem disponíveis no ponto de distribuição em grupos de limites atuais, vizinhos ou de site, baixe o conteúdo do Microsoft Atualizações.

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

-BeginCondition

Especifique uma opção para iniciar esta fase de implantação após o sucesso da fase anterior:

• AfterPeriod: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: inicie automaticamente essa fase após um período de adiamento (em dias). Se você especificar esse valor, use DaysAfterPreviousPhaseSuccess para configurar o período de tempo.

• Manually: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: inicie manualmente essa fase de implantação.

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

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

Type:	IResultObject
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

Especifique a coleção de destino por ID.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Especifique a coleção de destino pelo nome.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaOption

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

• Compliance: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: percentual de sucesso da implantação. Especifique o valor percentual com o parâmetro CriteriaValue .

• Number: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: número de dispositivos implantados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue .

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

Esse valor inteiro depende do valor que você especifica para CriteriaOption:

• Compliance: especifique o percentual

• Number: especifique o número de dispositivos

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

-DaysAfterPreviousPhaseSuccess

Especifique um valor inteiro para o número de dias após o sucesso da fase anterior para iniciar essa fase. Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: inicie automaticamente essa fase após um período de adiamento (em dias).

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

-DeadlineUnit

Especifique o tipo de período de prazo. Use esse parâmetro com DeadlineValue.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

Esse parâmetro só será usado se você especificar AfterPeriod com o parâmetro InstallationChoice .

Especifique um valor inteiro para o período de tempo do prazo. Use o parâmetro DeadlineUnit para especificar o tipo de período: Hours, , Days, Weeks. Months Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: a instalação é necessária após esse período de tempo.

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

-DisableScomAlert

Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Fase de Adição no console: Desabilitar alertas do Operations Manager enquanto as atualizações de software são executadas.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-EnableAlert

Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Fase de Adição no console: Gere um alerta quando as seguintes condições forem atendidas. Ao definir esse parâmetro como $true, também defina os seguintes parâmetros:

• AlertThresholdPercentage
• AlertDelta

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

-EnableWakeOnLan

Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Implantação do Assistente de Fase de Adição no console: Use Wake-on-LAN para acordar clientes para implantações necessárias.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado. Não é recomendável. Você não pode combiná-lo com DisableWildcardHandling.

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

-GenerateScomAlertOnFailure

Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Fase de Adição no console: Gerar alerta do Operations Manager quando uma instalação de atualização de software falhar.

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

-InstallationChoice

Especifique uma opção para o comportamento relativo a quando o software é disponibilizado:

• AsSoonAsPossible: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: a instalação é necessária o mais rápido possível.

• AfterPeriod: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: a instalação é necessária após esse período de tempo. Se você especificar esse valor, use DeadlineUnit e DeadlineValue para configurar o período de tempo.

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PhaseDescription

Especifique uma descrição para a fase.

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

-PhaseName

Especifique um nome para a descrição.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequirePostRebootFullScan

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: se qualquer atualização nesta implantação exigir uma reinicialização do sistema, execute o ciclo de avaliação de implantação de atualizações após a reinicialização.

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

-ServerRestartSuppression

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console. Suprimir a reinicialização do sistema nos seguintes dispositivos: Servidores.

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

-SoftwareInstallation

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: Instalação de Software. Essa configuração se aplica quando o prazo de instalação é atingido, para permitir que essa atividade seja executada fora da janela de manutenção.

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

-StateMessageVerbosity

Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Implantação do Assistente de Fase de Adição no console: Estado no nível de detalhes da mensagem com os seguintes valores:

• AllMessages: todas as mensagens
• OnlySuccessAndErrorMessages: somente mensagens de sucesso e erro
• OnlyErrorMessages: somente mensagens de erro

Type:	VerbosityLevelType
Accepted values:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThrottlingDays

Especifique um valor inteiro para o número de dias para disponibilizar gradualmente esse software. Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: disponibilize gradualmente esse software durante esse período de tempo (em dias).

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

-UseNeighborDP

Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Download do Assistente de Fase de Adição no console: selecione a opção de implantação a ser usada quando um cliente usa um ponto de distribuição de um grupo de limites vizinho ou do grupo de limites do site padrão. Especifique os seguintes valores:

• $true: baixar atualizações de software do ponto de distribuição e instalar
• $false: não instale atualizações de software

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

-UserNotificationOption

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: especifique a configuração de experiência do usuário para essa implantação com os seguintes valores:

• DisplayAll: exibir no Centro de Software e mostrar todas as notificações
• DisplaySoftwareCenterOnly: exibir no Centro de Software e mostrar apenas notificações para reinicializações do computador
• HideAll: Ocultar no Centro de Software e todas as notificações

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSiteDefaultDP

Esse parâmetro é o mesmo que a seguinte configuração na página Baixar Configurações do Assistente de Fase de Adição no console: quando as atualizações de software não estão disponíveis em nenhum ponto de distribuição no grupo de limites atual ou vizinho, o cliente pode baixar e instalar atualizações de software de pontos de distribuição no grupo de limites padrão do site. Especifique os seguintes valores:

• $true: baixar e instalar atualizações de software dos pontos de distribuição no grupo de limites padrão do site
• $false: não instale atualizações de software

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkstationRestartSuppression

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console. Suprimir a reinicialização do sistema nos seguintes dispositivos: estações de trabalho.

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

-WriteFilterCommit

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: Confirmar alterações no prazo ou durante uma janela de manutenção (requer reinicialização). Essa configuração se aplica ao tratamento de filtro de gravação para dispositivos Windows Embedded.

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

Entradas

None

Saídas

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase