Set-CMTaskSequencePhase
Use este cmdlet para configurar una fase de implementación para una secuencia de tareas.
Sintaxis
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-InputObject] <IResultObject>
[-Name <String>]
[-Order <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-Name <String>]
[-Order <Int32>]
[-PhasedDeploymentId] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMTaskSequencePhase
[-AllowFallback <Boolean>]
[-AllowRemoteDP <Boolean>]
[-AllowSystemRestart <Boolean>]
[-Comments <String>]
[-DeploymentOption <DeploymentOptionType>]
[-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>]
[-UserNotification <UserNotificationType>]
[-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-MovePhase <ReorderType>]
[-MoveToOrder <Int32>]
[-NewCollection <IResultObject>]
[-NewCollectionId <String>]
[-NewCollectionName <String>]
[-NewPhaseName <String>]
[-ThrottlingDays <Int32>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-Id <String>]
[-Name <String>]
[-Order <Int32>]
[-PhasedDeploymentName] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Se aplica a la versión 2006 y versiones posteriores. Use este cmdlet para configurar una fase de implementación para una secuencia de tareas. Para obtener más información, consulte Creación de implementaciones por fases.
Ejemplos
Ejemplo 1: Cambio de la colección
En este ejemplo se cambia la colección de la segunda fase de la implementación por fases de la secuencia de tareas que se pasa en la línea de comandos.
$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"
$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"
Ejemplo 2: Subir una fase
En este ejemplo se mueve una fase hacia arriba en el orden. Selecciona la implementación por fases por su identificador y selecciona la fase por el identificador de colección asociado.
Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp
Ejemplo 3: Configuración de la fase
En este ejemplo se cambian los valores de configuración de la fase seleccionada.
Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12
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.
Tipo: | Boolean |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
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 |
-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
Especificar un objeto para la colección de destino
Tipo: | IResultObject |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CollectionId
Especifique la colección de destino por identificador.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CollectionName
Especifique la colección de destino por nombre.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Comments
Especifique comentarios opcionales para esta fase. La longitud máxima es de 512 caracteres.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
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 |
-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.
Tipo: | DeploymentOptionType |
Valores aceptados: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
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 |
-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 |
-Id
Especifique el identificador de la fase que se va a configurar.
Tipo: | String |
Alias: | PhaseId |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-InputObject
Especifique un objeto de implementación por fases que incluya la fase que se va a configurar.
Tipo: | IResultObject |
Alias: | PhasedDeployment |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
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 |
-MovePhase
Cambie el orden de la fase seleccionada. Puede moverlo hacia arriba, bajarlo uno o moverlo a un índice específico. Si especifica MoveToOrder
, use el parámetro -MoveToOrder para establecer el índice específico.
Tipo: | ReorderType |
Valores aceptados: | MoveUp, MoveDown, MoveToOrder |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MoveToOrder
Cuando establezca el parámetro -MovePhase en MoveToOrder
, use este parámetro para establecer el índice específico.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Especifique el nombre de la fase que se va a configurar.
Tipo: | String |
Alias: | PhaseName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NewCollection
Especifique un objeto de colección que se usará como nuevo destino para la fase seleccionada.
Tipo: | IResultObject |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NewCollectionId
Especifique una colección por identificador que se usará como nuevo destino para la fase seleccionada.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NewCollectionName
Especifique una colección por nombre que se usará como nuevo destino para la fase seleccionada.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NewPhaseName
Use este parámetro para cambiar el nombre de la fase seleccionada.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Order
Especifique el índice de la fase que se va a configurar.
Tipo: | Int32 |
Alias: | PhaseOrder |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PhasedDeploymentId
Seleccione la implementación por fases por identificador. A continuación, use otros parámetros para seleccionar la fase específica de esa implementación.
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PhasedDeploymentName
Seleccione la implementación por fases por nombre. A continuación, use otros parámetros para seleccionar la fase específica de esa implementación.
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-PreDownload
Este parámetro es el mismo que el siguiente en la página General del Asistente para agregar fases en la consola: Descargar previamente contenido para esta secuencia de tareas.
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 |
-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 |
-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
Tipo: | UserNotificationType |
Valores aceptados: | DisplayAll, HideAll |
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 |
-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
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject
Vínculos relacionados
- Get-CMPhase
- New-CMTaskSequencePhase
- Get-CMTaskSequencePhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequenceManualPhasedDeployment
- Remove-CMTaskSequencePhasedDeployment
- Set-CMTaskSequencePhasedDeployment
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- Creación de implementaciones por fases