New-CMTaskSequencePhase

Módulo:

ConfigurationManager

Use este cmdlet para crear una fase de implementación para una secuencia de tareas.

Syntax

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear una fase de implementación para una secuencia de tareas.

Ejemplos

Ejemplo 1: Creación de una fase de secuencia de tareas

En este ejemplo se crea una fase de secuencia de tareas denominada MyTSPhase para la colección denominada MyCollection.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Parámetros

-AllowFallback

Este parámetro es el mismo que el siguiente en la página Puntos de distribución del Asistente para agregar fases en la consola: Permitir que los clientes usen puntos de distribución del grupo de límites de sitio predeterminado.

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

-AllowRemoteDP

Este parámetro es el mismo que el siguiente en la página Puntos de distribución del Asistente para agregar fases en la consola: cuando no hay ningún punto de distribución local disponible, use un punto de distribución remoto.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Collection

Especificar un objeto para la colección de destino

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

-CollectionId

Especifique la colección de destino por identificador.

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

-CollectionName

Especifique la colección de destino por nombre.

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

-Comments

Especifique comentarios opcionales para esta fase. La longitud máxima es de 512 caracteres.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-CriteriaValue

Este valor entero depende del valor que especifique para CriteriaOption:

• Compliance: especifique el porcentaje.

• Number: especifique el número de dispositivos.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-DeadlineUnit

Especifique el tipo de período de fecha límite. Use este parámetro con 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

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.

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

-DeploymentOption

Este parámetro es el mismo que el siguiente en la página Puntos de distribución 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 el grupo de límites de sitio predeterminado. Acepta los siguientes valores:

• DownloadContentLocallyWhenNeededByRunningTaskSequence: descargue contenido localmente cuando sea necesario para la secuencia de tareas en ejecución.
• DownloadAllContentLocallyBeforeStartingTaskSequence: descargue todo el contenido localmente antes de iniciar la secuencia de tareas.

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-PhaseName

Especifique un nombre para la fase.

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

-PreDownload

Este parámetro es el mismo que el siguiente en la página General del Asistente para agregar fases en la consola: Descarga previa del contenido de esta secuencia de tareas.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-UserNotification

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
• HideAll: ocultar en el Centro de software y todas las notificaciones

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Entradas

None

Salidas

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase