Set-CMTaskSequencePhase
Use este cmdlet para configurar una fase de implementación para una secuencia de tareas.
Syntax
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, vea Create phased deployments.
Ejemplos
Ejemplo 1: Cambiar 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 pasada en la línea de comandos.
$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"
$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"
Ejemplo 2: Mover una fase hacia arriba
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: Configurar las opciones de fase
En este ejemplo se cambian las opciones 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
- 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 |
-AllowFallback
Este parámetro es el mismo que **** el siguiente **** valor 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRemoteDP
Este parámetro es el mismo que **** el siguiente **** valor 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, useun punto de distribución remoto .
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSystemRestart
Este parámetro es el mismo que **** la siguiente **** configuración 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
Especifique una opción para iniciar esta fase de implementación después del éxito de la fase anterior:
AfterPeriod
: Este parámetro es el mismo que la siguiente configuración **** en la página Fase Configuración del Asistente para agregar fase 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 el siguiente valor **** en la página Fase Configuración del Asistente para agregar fase en la consola: Inicie manualmente esta fase de implementación.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especificar un objeto para la colección de destino
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique la colección de destino por identificador.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique la colección de destino por su nombre.
Type: | String |
Position: | Named |
Default value: | None |
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 |
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 valor en la página Fase Configuración del Asistente para agregar fase 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 Fase Configuración 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
Este valor entero depende del valor especificado para CriteriaOption:
Compliance
: especifique el porcentajeNumber
: 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 fase anterior para comenzar esta fase. Este parámetro es el mismo que el siguiente valor en **** la página Fase Configuración del Asistente para agregar 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 Fase Configuración del Asistente para agregar fase 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 |
-DeploymentOption
Este parámetro es el mismo que **** el siguiente **** valor 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 de vecinos o del grupo de límites de sitio predeterminado. Acepta los siguientes valores:
DownloadContentLocallyWhenNeededByRunningTaskSequence
: Descargar contenido localmente cuando sea necesario en la secuencia de tareas en ejecuciónDownloadAllContentLocallyBeforeStartingTaskSequence
: Descargar todo el contenido localmente antes de iniciar la secuencia de tareas
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
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 |
-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 |
-Id
Especifique el identificador de la fase que se debe configurar.
Type: | String |
Aliases: | PhaseId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique un objeto de implementación por fases que incluya la fase que se debe configurar.
Type: | IResultObject |
Aliases: | PhasedDeployment |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
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 Fase Configuración del Asistente para agregar 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 Fase Configuración del Asistente para agregar fase 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 |
-MovePhase
Cambie el orden de la fase seleccionada. Puede subir uno, bajar uno o pasar a un índice específico. Si especifica MoveToOrder
, use el parámetro -MoveToOrder para establecer el índice específico.
Type: | ReorderType |
Accepted values: | MoveUp, MoveDown, MoveToOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MoveToOrder
Cuando establezca el parámetro -MovePhase en MoveToOrder
, use este parámetro para establecer el índice específico.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique el nombre de la fase que se debe configurar.
Type: | String |
Aliases: | PhaseName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollection
Especifique un objeto de colección que se usará como nuevo destino para la fase seleccionada.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionId
Especifique una colección por identificador que se usará como nuevo destino para la fase seleccionada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewCollectionName
Especifique una colección por su nombre que se usará como nuevo destino para la fase seleccionada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewPhaseName
Use este parámetro para cambiar el nombre de la fase seleccionada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Order
Especifique el índice de la fase que se debe configurar.
Type: | Int32 |
Aliases: | PhaseOrder |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDownload
Este parámetro es el mismo que el siguiente **** valor de la página General del Asistente para agregar fases en la consola: Descargar previamente el contenido de esta secuencia de tareas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Este parámetro es el mismo que la siguiente configuración 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 |
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 Fase Configuración del Asistente para agregar 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 |
-UserNotification
Este parámetro es el mismo que **** la siguiente **** configuración 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
: Mostrar en el Centro de software y mostrar todas las notificacionesHideAll
: Ocultar en el Centro de software y todas las notificaciones
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
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 |
-WriteFilterCommit
Este parámetro es el mismo que **** la siguiente **** configuración 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 Windows dispositivos incrustados.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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
- Crear implementaciones por fases