Partilhar via

New-CMSoftwareUpdatePhase

  • Artigo

SYNOPSIS

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

SYNTAX

SearchByCollection

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>]

SearchByCollectionId

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>]

SearchByCollectionName

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

A partir da versão 2002, utilize este cmdlet para criar uma fase de implementação para a atualização do software.

EXAMPLES

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 só será exibida no Software Center.

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

PARAMETERS

-AlertaDelta

Este parâmetro é o mesmo que a seguinte definição na página alertas do Assistente de Fase de Adição na consola: Compensação a partir do prazo de entrega. Especifique um valor inteiro para a compensação 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.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertaThresholdPercentage

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

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Alerta Unidade

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

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-Permitir a Ligação DeMetered

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PermitirSystemRestart

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente de Fase de Adicionar na consola: Reiniciar o 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 executada fora da janela de manutenção.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowWumuFallback

Este parâmetro é o mesmo que a seguinte definição na página de descarregamento Definições do Assistente de Fase de Adicionar na consola: Se as atualizações de software não estiverem disponíveis no ponto de distribuição nos grupos de fronteira atuais, vizinhos ou do site, descarregue o conteúdo das Atualizações do Microsoft.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Iniciar a Condição

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

  • AfterPeriod: Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Inicie 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 fase Definições do Assistente de Fase de Adição na consola: Iniciar manualmente esta fase de implantação.

Type: BeginConditionType
Parameter Sets: (All)
Aliases:
Accepted values: AfterPeriod, Manually

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

-Coleção

Especifique um objeto para a recolha do alvo.

Type: IResultObject
Parameter Sets: SearchByCollection
Aliases:

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

-CollectionId

Especifique a recolha do alvo por ID.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

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

-Nome de coleção

Especifique a recolha do alvo pelo nome.

Type: String
Parameter Sets: SearchByCollectionName
Aliases:

Required: True
Position: 0
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

-CritériosOpção

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

  • Compliance: Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Percentagem de sucesso de implementação. Especifique o valor percentual com o parâmetro CriteriaValue.

  • Number: Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Número de dispositivos implantados com sucesso. Especificar o número de dispositivos com o parâmetro CriteriaValue.

Type: CriteriaType
Parameter Sets: (All)
Aliases:
Accepted values: Compliance, Number

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

-CritériosValue

Este valor inteiro depende do valor que especifica para critérioOpoption:

  • Compliance: Especificar a percentagem

  • Number: Especificar o número de dispositivos

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
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 esta fase. Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Inicie automaticamente esta fase após um período de diferimento (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

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

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-PrazoSValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstalaçãoChoice.

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 fase Definições do Assistente de Fase de Adição na consola: A instalação é necessária após este período de tempo.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DisablescomAlert

Este parâmetro é o mesmo que a seguinte definição na página alertas do Assistente de Fase de Adicionar na consola: Desativa os alertas do Gestor de Operações enquanto as atualizações de software são executadas.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableAlert

Este parâmetro é o mesmo que a seguinte definição na página alertas do Assistente de Fase de Adicionar na consola: Gerar um alerta quando estiverem reunidas as seguintes condições. Quando definir este parâmetro para $true , também desa um determinado parâmetro:

  • AlertaThresholdPercentage
  • AlertaDelta
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableWakeOnLan

Este parâmetro é o mesmo que a seguinte definição na página de Definições de implementação do Assistente de Fase de Adição na consola: Utilize Wake-on-LAN para acordar os clientes para as implementações necessárias.

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

-GeneratescomAlertOnFailure

Este parâmetro é o mesmo que a seguinte definição na página alertas do Assistente de Fase de Adicionar na consola: Gerar alerta de Gestor de Operações quando uma instalação de atualização de software falha.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstalaçãoChoice

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

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

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

Type: InstallationChoiceType
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, AfterPeriod

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

-Descrição fase

Especifique uma descrição para a fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-FaseName

Especifique um nome para a descrição.

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

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

-RequirePostRebootFullScan

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ServerRestartSuppression

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Instalação de Software

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-StateMessageVerbosity

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

  • AllMessages: Todas as mensagens
  • OnlySuccessAndErrorMessages: Apenas mensagens de sucesso e erro
  • OnlyErrorMessages: Apenas mensagens de erro
Type: VerbosityLevelType
Parameter Sets: (All)
Aliases:
Accepted values: AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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 fase Definições do Assistente de Fase de Adição na consola: Gradualmente disponibilizar este software durante este período de tempo (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-UseNeighborDP

Este parâmetro é o mesmo que a seguinte definição na página de descarregamento Definições do Assistente de Fase de Adição na consola: Selecione a opção de implementação a utilizar quando um cliente utiliza um ponto de distribuição de um grupo de fronteira do vizinho ou do grupo de fronteira do site padrão. Especificar os seguintes valores:

  • $true: Descarregue atualizações de software a partir do ponto de distribuição e instale
  • $false: Não instale atualizações de software
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseSiteDefaultDP

Este parâmetro é o mesmo que a seguinte definição na página de descarregamento Definições do Assistente de Fase de Adicionar na consola: Quando as atualizações de software não estiverem disponíveis em quaisquer pontos de distribuição no grupo de fronteira atual ou vizinho, o cliente pode descarregar e instalar atualizações de software a partir de pontos de distribuição no grupo de fronteira padrão do site. Especificar os seguintes valores:

  • $true: Descarregue e instale atualizações de software a partir dos pontos de distribuição no grupo de fronteira padrão do site
  • $false: Não instale atualizações de software
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Opção de Notificação de Utilizador

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

  • DisplayAll: Exibir no Centro de Software e mostrar todas as notificações
  • DisplaySoftwareCenterOnly: Exibir no Software Center e apenas mostrar notificações para reiniciar computador
  • HideAll: Esconder-se no Centro de Software e todas as notificações
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll

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

-workstationRestartSuppression

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WriteFilterCommit

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

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

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

NOTAS