Use este cmdlet para criar uma fase de implantação para atualização de software.
\n","uid":"ConfigurationManager.New-CMSoftwareUpdatePhase"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMSoftwareUpdatePhase":{"href":"new-cmsoftwareupdatephase","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMSoftwareUpdatePhase","schemaType":"PowershellCmdlet","summary":"Use este cmdlet para criar uma fase de implantação para atualização de software.
\n","uid":"ConfigurationManager.New-CMSoftwareUpdatePhase"}},"description":"Use este cmdlet para criar uma fase de implantação para atualização de software.
\n","examples":[{"code":"New-CMSoftwareUpdatePhase `\n -CollectionName \"MyCollection\" `\n -PhaseName \"MySUPhase\" `\n -UserNotificationOption DisplaySoftwareCenterOnly","description":"","summary":"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.
\n","title":"Exemplo 1: Criar uma fase de atualização de software"}],"inputs":[{"description":"","name":"None\n"}],"module":"ConfigurationManager","name":"New-CMSoftwareUpdatePhase","notes":"","outputs":[{"description":"","name":"Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Alertas do Assistente de Adicionar Fase no console: Deslocamento a partir da hora limite. Especifique um valor inteiro para o deslocamento e, em seguida, especifique o tipo de período com o parâmetro AlertUnit .
\nPara definir esse valor, você precisa usar o parâmetro EnableAlert .
\n","name":"AlertDelta","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Alertas do Assistente de Adicionar Fase no console: A conformidade do cliente está abaixo do seguinte (percentual). Especifique um valor inteiro para a porcentagem. Para definir esse valor, você precisa usar o parâmetro EnableAlert .
\n","name":"AlertThresholdPercentage","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifique o tipo de período. Use esse parâmetro com AlertDelta.
\n","name":"AlertUnit","parameterValueGroup":"Hours, Days, Weeks, Months","position":"Named","type":"TimeUnitType\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Download do Assistente de Adicionar Fase no console: Permitir que clientes em uma conexão limitada com a Internet baixem conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.
\n","name":"AllowMeteredConnection","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"AllowSystemRestart","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Download do Assistente de Adicionar Fase no console: Se as atualizações de software não estiverem disponíveis no ponto de distribuição nos grupos atual, vizinho ou de limite do site, baixe o conteúdo do Microsoft Atualizações.
\n","name":"AllowWumuFallback","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma opção para iniciar essa fase de implantação após o êxito da fase anterior:
\n\n AfterPeriod: Este parâmetro é o mesmo que a configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: Comece 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.
\n Manually: Este parâmetro é o mesmo que a configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: Comece manualmente esta fase de implantação.
Especifique um objeto para a coleção de destino.
\n","isRequired":true,"name":"Collection","parameterValueGroup":"","position":"0","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Especifique a coleção de destino por ID.
\n","isRequired":true,"name":"CollectionId","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique a coleção de destino por nome.
\n","isRequired":true,"name":"CollectionName","parameterValueGroup":"","position":"0","type":"String\n"},{"aliases":"cf","defaultValue":"None","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma opção para escolher os critérios para o sucesso da fase anterior:
\n\n Compliance: Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: Percentual de sucesso na implantação. Especifique o valor percentual com o parâmetro CriteriaValue .
\n Number: Este parâmetro é o mesmo que a configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: Número de dispositivos implantados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue .
Esse valor inteiro depende do valor especificado para CriteriaOption:
\n\n Compliance: Especifique a porcentagem
\n Number: especifique o número de dispositivos
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 configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: Comece automaticamente essa fase após um período de adiamento (em dias).
\n","name":"DaysAfterPreviousPhaseSuccess","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Especifique o tipo de prazo. Use esse parâmetro com DeadlineValue.
\n","name":"DeadlineUnit","parameterValueGroup":"Hours, Days, Weeks, Months","position":"Named","type":"TimeUnitType\n"},{"aliases":"","defaultValue":"None","description":"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 configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: A instalação é necessária após esse período de tempo.
Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Adicionar Fase no console: Desabilite os alertas do Operations Manager enquanto as atualizações de software são executadas.
\n","name":"DisableScomAlert","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Alertas do Assistente de Adicionar Fase no console: Gere um alerta quando as condições a seguir forem atendidas. Ao definir esse parâmetro para $true, defina também os seguintes parâmetros:
Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Implantação do Assistente de Adicionar Fase no console: Use o Wake-on-LAN para ativar os clientes para as implantações necessárias.
\n","name":"EnableWakeOnLan","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado. Não é recomendado. Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a seguinte configuração na página Alertas do Assistente de Adicionar Fase no console: Gerar um alerta do Operations Manager quando uma instalação de atualização de software falhar.
\n","name":"GenerateScomAlertOnFailure","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma opção para o comportamento relativo a quando o software for disponibilizado:
\n\n AsSoonAsPossible: Este parâmetro é o mesmo que a configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: A instalação é necessária o mais rápido possível.
\n AfterPeriod: Este parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente para Adicionar Fase 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.
Especifique uma descrição para a fase.
\n","name":"PhaseDescription","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Name","defaultValue":"None","description":"Especifique um nome para a descrição.
\n","isRequired":true,"name":"PhaseName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console: Se alguma atualização nessa 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.
\n","name":"RequirePostRebootFullScan","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console. Suprima a reinicialização do sistema nos seguintes dispositivos: Servidores.
\n","name":"ServerRestartSuppression","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"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: 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.
\n","name":"SoftwareInstallation","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Implantação do Assistente de Adicionar Fase no console: Nível de detalhes da mensagem de estado com os seguintes valores:
\nAllMessages: Todas as mensagensOnlySuccessAndErrorMessages: Somente mensagens de sucesso e de erroOnlyErrorMessages: Somente mensagens de erroEspecifique um valor inteiro para o número de dias para disponibilizar gradualmente este software. Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Fase do Assistente para Adicionar Fase no console: Disponibilize gradualmente este software durante esse período de tempo (em dias).
\n","name":"ThrottlingDays","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Configurações de Download do Assistente de Adicionar Fase no console: Selecione a opção de implantação a ser usada quando um cliente usar um ponto de distribuição de um grupo de limites vizinho ou do grupo de limites do site padrão. Especifique os seguintes valores:
\n$true: baixe as atualizações de software do ponto de distribuição e instale$false: não instale atualizações de softwareEsse parâmetro é o mesmo que a configuração a seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console: Especifique a configuração de experiência do usuário para esta implantação com os seguintes valores:
\nDisplayAll: Exibir no Centro de Software e mostrar todas as notificaçõesDisplaySoftwareCenterOnly: exibição no Centro de Software e mostrar apenas notificações de reinicialização do computadorHideAll: Ocultar no Centro de Software e em todas as notificaçõesEsse parâmetro é o mesmo que a configuração a seguir na página Configurações de Download do Assistente de Adicionar Fase 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:
\n$true: Baixe e instale atualizações de software dos pontos de distribuição no grupo de limites padrão do site$false: não instale atualizações de softwareMostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console. Suprima a reinicialização do sistema nos seguintes dispositivos: Estações de trabalho.
\n","name":"WorkstationRestartSuppression","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro é o mesmo que a configuração a seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console: Confirmar alterações no prazo ou durante uma janela de manutenção (requer reinicialização). Essa configuração se aplica ao manuseio de filtro de gravação para dispositivos Windows Embedded.
\n","name":"WriteFilterCommit","parameterValueGroup":"","position":"Named","type":"Boolean\n"}],"schema":"PowershellCmdlet","summary":"Use este cmdlet para criar uma fase de implantação para atualização de software.
\n","syntaxes":["New-CMSoftwareUpdatePhase [-AlertDeltaUse este cmdlet para criar uma fase de implantação para atualização de software.
\n","uid":"ConfigurationManager.New-CMSoftwareUpdatePhase"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmsoftwareupdatephase?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmsoftwareupdatephase?view=sccm-ps"},"pageMetadata":"Use este cmdlet para criar uma fase de implantação para atualização de software.\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\nUse este cmdlet para criar uma fase de implantação para atualização de software.\n\" />\r\n] [-AlertThresholdPercentage