New-CMSoftwareUpdatePhase

Módulo:

ConfigurationManager

Use este cmdlet para crear una fase de implementación para la actualización de software.

Sintaxis

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 crear una fase de implementación para la actualización de software.

Ejemplos

Ejemplo 1: Creación de una fase de actualización de software

En este ejemplo se crea una fase de actualización de software denominada MySUPhase para la colección denominada MyCollection que solo se mostrará en el Centro de software.

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

Parámetros

-AlertDelta

Este parámetro es el mismo que el siguiente en la página Alertas del Asistente para agregar fases en la consola: Desplazamiento desde la hora límite. Especifique un valor entero para el desplazamiento y, a continuación, especifique el tipo de período con el parámetro AlertUnit .

Para establecer este valor, debe usar el parámetro EnableAlert .

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AlertThresholdPercentage

Este parámetro es el mismo que el siguiente en la página Alertas del Asistente para agregar fases en la consola: El cumplimiento del cliente está por debajo del siguiente (porcentaje). Especifique un valor entero para el porcentaje. Para establecer este valor, debe usar el parámetro EnableAlert .

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AlertUnit

Especifique el tipo de punto. Use este parámetro con AlertDelta.

Tipo:	TimeUnitType
Valores aceptados:	Hours, Days, Weeks, Months
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowMeteredConnection

Este parámetro es el mismo que el siguiente en la página Configuración de descarga del Asistente para agregar fases en la consola: Permitir que los clientes de una conexión a Internet de uso medido descarguen contenido después de la fecha límite de instalación, lo que podría suponer costos adicionales.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowSystemRestart

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola: Reinicio del sistema (si es necesario para completar la instalación). Esta configuración se aplica cuando se alcanza la fecha límite de instalación, para permitir que esta actividad se realice fuera de la ventana de mantenimiento.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AllowWumuFallback

Este parámetro es el mismo que el siguiente en la página Configuración de descarga del Asistente para agregar fases en la consola: si las actualizaciones de software no están disponibles en el punto de distribución en grupos de límites actuales, vecinos o de sitio, descargue contenido de Microsoft Updates.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BeginCondition

Especifique una opción para iniciar esta fase de implementación después de que se haya realizado correctamente la fase anterior:

• AfterPeriod: este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: comienza automáticamente esta fase después de un período de aplazamiento (en días). Si especifica este valor, use DaysAfterPreviousPhaseSuccess para configurar el período de tiempo.

• Manually: este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: comience manualmente esta fase de implementación.

Tipo:	BeginConditionType
Valores aceptados:	AfterPeriod, Manually
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Collection

Especifique un objeto para la colección de destino.

Tipo:	IResultObject
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionId

Especifique la colección de destino por identificador.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CollectionName

Especifique la colección de destino por nombre.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CriteriaOption

Especifique una opción para elegir los criterios de éxito de la fase anterior:

• Compliance: este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: Porcentaje de éxito de implementación. Especifique el valor de porcentaje con el parámetro CriteriaValue .

• Number: este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: número de dispositivos implementados correctamente. Especifique el número de dispositivos con el parámetro CriteriaValue .

Tipo:	CriteriaType
Valores aceptados:	Compliance, Number
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CriteriaValue

Este valor entero depende del valor que especifique para CriteriaOption:

• Compliance: especifique el porcentaje.

• Number: especifique el número de dispositivos.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DaysAfterPreviousPhaseSuccess

Especifique un valor entero para el número de días posteriores al éxito de la fase anterior para comenzar esta fase. Este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: comience automáticamente esta fase después de un período de aplazamiento (en días).

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeadlineUnit

Especifique el tipo de período de fecha límite. Use este parámetro con DeadlineValue.

Tipo:	TimeUnitType
Valores aceptados:	Hours, Days, Weeks, Months
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeadlineValue

Este parámetro solo se usa si se especifica AfterPeriod con el parámetro InstallationChoice .

Especifique un valor entero para el período de tiempo de la fecha límite. Use el parámetro DeadlineUnit para especificar el tipo de período: Hours, Days, Weeks, Months. Este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: La instalación es necesaria después de este período de tiempo.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableScomAlert

Este parámetro es el mismo que el siguiente en la página Alertas del Asistente para agregar fases en la consola: Deshabilitar alertas de Operations Manager mientras se ejecutan las actualizaciones de software.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EnableAlert

Este parámetro es el mismo que el siguiente en la página Alertas del Asistente para agregar fases en la consola: Generar una alerta cuando se cumplen las condiciones siguientes. Al establecer este parámetro en $true, establezca también los parámetros siguientes:

• AlertThresholdPercentage
• AlertDelta

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-EnableWakeOnLan

Este parámetro es el mismo que el siguiente en la página Configuración de implementación del Asistente para agregar fases en la consola: Use Wake-on-LAN para reactivar clientes para las implementaciones necesarias.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado. No se recomienda. No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-GenerateScomAlertOnFailure

Este parámetro es el mismo que el siguiente en la página Alertas del Asistente para agregar fases en la consola: Generar alerta de Operations Manager cuando se produce un error en la instalación de una actualización de software.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InstallationChoice

Especifique una opción para el comportamiento relativo a cuando el software esté disponible:

• AsSoonAsPossible: este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: La instalación se requiere lo antes posible.

• AfterPeriod: este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: La instalación es necesaria después de este período de tiempo. Si especifica este valor, use DeadlineUnit y DeadlineValue para configurar el período de tiempo.

Tipo:	InstallationChoiceType
Valores aceptados:	AsSoonAsPossible, AfterPeriod
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PhaseDescription

Especifique una descripción para la fase.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PhaseName

Especifique un nombre para la descripción.

Tipo:	String
Alias:	Name
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RequirePostRebootFullScan

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola: Si alguna actualización de esta implementación requiere un reinicio del sistema, ejecute el ciclo de evaluación de la implementación de actualizaciones después del reinicio.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServerRestartSuppression

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola. Suprima el reinicio del sistema en los siguientes dispositivos: Servidores.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SoftwareInstallation

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola: Instalación de software. Esta configuración se aplica cuando se alcanza la fecha límite de instalación, para permitir que esta actividad se realice fuera de la ventana de mantenimiento.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StateMessageVerbosity

Este parámetro es el mismo que el siguiente en la página Configuración de implementación del Asistente para agregar fases en la consola: Nivel de detalle del mensaje de estado con los valores siguientes:

• AllMessages: todos los mensajes
• OnlySuccessAndErrorMessages: solo mensajes de error y correctos
• OnlyErrorMessages: solo mensajes de error

Tipo:	VerbosityLevelType
Valores aceptados:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ThrottlingDays

Especifique un valor entero para el número de días para que este software esté disponible gradualmente. Este parámetro es el mismo que el siguiente en la página Configuración de fase del Asistente para agregar fases en la consola: Hacer que este software esté disponible gradualmente durante este período de tiempo (en días).

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseNeighborDP

Este parámetro es el mismo que el siguiente en la página Configuración de descarga del Asistente para agregar fases en la consola: seleccione la opción de implementación que se usará cuando un cliente use un punto de distribución de un grupo de límites vecino o del grupo de límites de sitio predeterminado. Especifique los valores siguientes:

• $true: descarga de actualizaciones de software desde el punto de distribución e instalación
• $false: no instale actualizaciones de software

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserNotificationOption

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola: Especifique la configuración de la experiencia del usuario para esta implementación con los siguientes valores:

• DisplayAll: se muestra en el Centro de software y se muestran todas las notificaciones
• DisplaySoftwareCenterOnly: se muestra en el Centro de software y solo se muestran las notificaciones para reinicios del equipo.
• HideAll: ocultar en el Centro de software y todas las notificaciones

Tipo:	UserNotificationType
Valores aceptados:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UseSiteDefaultDP

Este parámetro es el mismo que el siguiente en la página Configuración de descarga del Asistente para agregar fases de la consola: cuando las actualizaciones de software no están disponibles en ningún punto de distribución del grupo de límites actual o vecino, el cliente puede descargar e instalar actualizaciones de software desde puntos de distribución del grupo de límites predeterminado del sitio. Especifique los valores siguientes:

• $true: descarga e instalación de actualizaciones de software desde los puntos de distribución del grupo de límites predeterminado del sitio
• $false: no instale actualizaciones de software

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WorkstationRestartSuppression

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola. Suprima el reinicio del sistema en los siguientes dispositivos: Estaciones de trabajo.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WriteFilterCommit

Este parámetro es el mismo que el siguiente en la página Experiencia del usuario del Asistente para agregar fases en la consola: Confirmar cambios en la fecha límite o durante una ventana de mantenimiento (requiere reinicio). Esta configuración se aplica al control de filtros de escritura para dispositivos Windows Embedded.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase