New-CMTaskSequenceAutoPhasedDeployment

  • Referencia
Módulo:
ConfigurationManager

Use este cmdlet para crear una implementación por fases para una secuencia de tareas mediante la generación de dos fases con la misma configuración.

Syntax

New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequence] <IResultObject>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequenceId] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequenceName] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear una implementación por fases para una secuencia de tareas mediante la generación de dos fases con la misma configuración. El comportamiento de este cmdlet **** es el mismo que el asistente para crear implementación por fases en una secuencia de tareas, cuando se selecciona la opción para crear automáticamente una implementación de dos fases predeterminada.

Nota

Antes de crear una implementación por fases, asegúrese de distribuir el contenido de la secuencia de tareas a un punto de distribución.

Ejemplos

Ejemplo 1: Crear una implementación por nombre de secuencia de tareas

En este ejemplo se crea una nueva implementación por fases de secuencia de tareas denominada myDPName para la secuencia de tareas myTaskSequenceName.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Ejemplo 2: Crear una implementación mediante el objeto de secuencia de tareas de entrada

En este ejemplo se crea una nueva implementación por fases de secuencia de tareas denominada myPDName para un objeto de secuencia de tareas canal.

$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

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

-AddPhases

Este cmdlet crea automáticamente dos fases para las dos colecciones especificadas. También puede agregar más fases con este parámetro. Especifique una matriz de fases. Use New-CMTaskSequencePhase para crear las fases.

Type:Phase[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-BeginCondition

Especifique una opción para iniciar la segunda fase de implementación después del éxito de la primera fase:

  • AfterPeriod: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del asistente para crear implementación por fases en la consola: inicie 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 la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: Inicie manualmente la implementación de la segunda fase.

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

-CriteriaOption

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

  • Compliance: Este parámetro es el mismo que el siguiente valor **** de la página Configuración del asistente para crear implementación por fases en la consola: Porcentaje de éxito de implementación. Especifique el valor porcentual con el parámetro CriteriaValue.

  • Number: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del asistente para crear implementación por 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
Accept pipeline input:False
Accept wildcard characters:False

-CriteriaValue

Este valor entero depende del valor especificado para CriteriaOption:

  • Compliance: especifique el porcentaje

  • Number: especifique el número de dispositivos

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

-DaysAfterPreviousPhaseSuccess

Especifique un valor entero para el número de días después del éxito de la primera fase para comenzar la segunda fase. Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: inicie automáticamente esta fase después de un período de aplazamiento (en días).

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

-DeadlineValue

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

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

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

-Description

Especifique una descripción para la implementación por fases de la secuencia de tareas.

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

-FirstCollection

Especifique un objeto de colección para la primera fase.

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

-FirstCollectionId

Especifique un identificador de colección para la primera fase.

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

-FirstCollectionName

Especifique un nombre de colección para la primera fase.

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

-InsertAtOrder

Si usa el parámetro AddPhases, use este parámetro para determinar dónde en el orden de las fases para insertar las fases adicionales. Especifique un número entero con el número de orden.

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

-InstallationChoice

Especifique una opción para el comportamiento con respecto al momento en que el software está disponible:

  • AsSoonAsPossible: Este parámetro es el mismo que la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: La instalación es necesaria tan pronto como sea posible.

  • AfterPeriod: Este parámetro es el mismo que la siguiente **** configuración en la página Configuración del asistente para crear implementación por 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
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique un nombre para la implementación por fases de la secuencia de tareas.

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

-SecondCollection

Especifique un objeto de colección para la segunda fase.

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

-SecondCollectionId

Especifique un identificador de colección para la segunda fase.

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

-SecondCollectionName

Especifique un nombre de colección para la segunda fase.

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

-TaskSequence

Especifique un objeto de secuencia de tareas.

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

-TaskSequenceId

Especifique una secuencia de tareas por identificador.

Type:String
Aliases:TaskSequencePackageId
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceName

Especifique una secuencia de tareas por su nombre.

Type:String
Position:0
Default value:None
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 la siguiente configuración **** en la página Configuración del Asistente para crear implementación por fases en la consola: haga que este software esté disponible gradualmente durante este período de tiempo (en días).

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject