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 percentagemNumber
: 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