Set-CMTaskSequencePhase

Módulo:

ConfigurationManager

Use este cmdlet para configurar uma fase de implantação para uma sequência de tarefas.

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

Aplica-se à versão 2006 e posterior. Use este cmdlet para configurar uma fase de implantação para uma sequência de tarefas. Para obter mais informações, consulte Create phased deployments.

Exemplos

Exemplo 1: Alterar a coleção

Este exemplo altera a coleção da segunda fase da implantação em fases da sequência de tarefas passada na linha de comando.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

Exemplo 2: mover uma fase para cima

Este exemplo move uma fase para cima na ordem. Ele seleciona a implantação em fases por sua ID e seleciona a fase pela ID da coleção associada.

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

Exemplo 3: Configurar configurações de fase

Este exemplo altera as configurações da fase selecionada.

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 é o mesmo que **** a configuração **** a seguir na página Pontos de Distribuição do Assistente de Adicionar Fase no console: Permitir que os clientes usem pontos de distribuição do grupo de limite de site padrão.

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

-AllowRemoteDP

Esse parâmetro é o mesmo da **** configuração a **** seguir na página Pontos de Distribuição do Assistente de Adicionar Fase no console: quando nenhum ponto de distribuição local estiver disponível, useum ponto de distribuição remoto .

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

-AllowSystemRestart

Este parâmetro é o mesmo que **** a configuração **** a seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console: Reinicialização do sistema (se necessário para concluir a instalação). Essa configuração se aplica quando o prazo de instalação é atingido, para permitir que essa atividade seja executada fora da janela de manutenção.

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

-BeginCondition

Especifique uma opção para iniciar essa fase de implantação após o sucesso da fase anterior:

• AfterPeriod: Este parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: Inicie automaticamente essa fase após um período de adiamento (em dias). Se você especificar esse valor, use DaysAfterPreviousPhaseSuccess para configurar o período de tempo.

• Manually: Este parâmetro é o mesmo que a configuração **** a seguir na página Fase Configurações do Assistente de Adicionar Fase no console: Inicie manualmente essa fase de implantação.

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

-Collection

Especificar um objeto para a coleção de destino

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

-CollectionId

Especifique a coleção de destino por ID.

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

-CollectionName

Especifique o conjunto de destino por nome.

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

-Comments

Especifique comentários opcionais para esta fase. O comprimento máximo é de 512 caracteres.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-CriteriaOption

Especifique uma opção para escolher os critérios de sucesso da fase anterior:

• Compliance: Este parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: Porcentagem de sucesso de implantação. Especifique o valor percentual com o parâmetro CriteriaValue.

• Number: Este parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: Número de dispositivos implantados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue.

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

-CriteriaValue

Esse valor inteiro depende do valor especificado para CriteriaOption:

• Compliance: Especifique a porcentagem

• Number: Especifique o número de dispositivos

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

-DaysAfterPreviousPhaseSuccess

Especifique um valor inteiro para o número de dias após o sucesso da fase anterior para iniciar essa fase. Esse parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: Inicie automaticamente essa fase após um período de adiamento (em dias).

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

-DeadlineUnit

Especifique o tipo de período de prazo. Use este parâmetro com DeadlineValue.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

Esse parâmetro só será usado se você especificar AfterPeriod com o parâmetro InstallationChoice.

Especifique um valor inteiro para o período de tempo do prazo limite. Use o parâmetro DeadlineUnit para especificar o tipo de ponto: Hours , , , Days Weeks Months . Este parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: a instalação é necessária após esse período de tempo.

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

-DeploymentOption

Este parâmetro é o mesmo que **** a configuração **** a seguir na página Pontos de Distribuição do Assistente de Adicionar Fase no console: Selecione a opção de implantação a ser usada quando um cliente usa um ponto de distribuição de um grupo de limite de vizinhos ou o grupo de limite de sitepadrão . Ele aceita os seguintes valores:

• DownloadContentLocallyWhenNeededByRunningTaskSequence: Baixe o conteúdo localmente quando necessário pela sequência de tarefas em execução
• DownloadAllContentLocallyBeforeStartingTaskSequence: Baixe todo o conteúdo localmente antes de iniciar a sequência de tarefas

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado. Não é recomendável. Não é possível combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID da fase a ser configurada.

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

-InputObject

Especifique um objeto de implantação em fases que inclui a fase a ser configurada.

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

-InstallationChoice

Especifique uma opção para o comportamento em relação ao momento em que o software é disponibilizado:

• AsSoonAsPossible: Este parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: A instalação é necessária assim que possível.

• AfterPeriod: Este parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: a instalação é necessária após esse período de tempo. Se você especificar esse valor, use DeadlineUnit e DeadlineValue para configurar o período de tempo.

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

-MovePhase

Altere a ordem da fase selecionada. Você pode movê-lo para cima um, movê-lo para baixo um ou mover para um índice específico. Se você especificar MoveToOrder , use o parâmetro -MoveToOrder para definir o índice específico.

Type:	ReorderType
Accepted values:	MoveUp, MoveDown, MoveToOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToOrder

Quando você definir o parâmetro -MovePhase como MoveToOrder , use esse parâmetro para definir o índice específico.

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

-Name

Especifique o nome da fase a ser configurada.

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

-NewCollection

Especifique um objeto de coleção a ser usado como o novo destino para a fase selecionada.

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

-NewCollectionId

Especifique uma coleção por ID a ser usada como o novo destino para a fase selecionada.

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

-NewCollectionName

Especifique uma coleção por nome a ser usada como o novo destino para a fase selecionada.

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

-NewPhaseName

Use esse parâmetro para renomear a fase selecionada.

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

-Order

Especifique o índice da fase a ser configurada.

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

-PhasedDeploymentId

Selecione a implantação em fases por ID. Em seguida, use outros parâmetros para selecionar a fase específica nessa implantação.

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

-PhasedDeploymentName

Selecione a implantação em fases pelo nome. Em seguida, use outros parâmetros para selecionar a fase específica nessa implantação.

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

-PreDownload

Esse parâmetro é o mesmo que a configuração a seguir na página Geral do Assistente de Adicionar Fase no console: **** Pré-download deconteúdo para esta sequência de tarefas .

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

-SoftwareInstallation

Esse parâmetro é o mesmo que **** a configuração a seguir na página Experiência do Usuário do Assistente para Adicionar Fases no console: Instalação de Software. Essa configuração se aplica quando o prazo de instalação é atingido, para permitir que essa atividade seja executada fora da janela de manutenção.

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

-ThrottlingDays

Especifique um valor inteiro para o número de dias para disponibilizar gradualmente esse software. Esse parâmetro é o mesmo que a configuração a **** seguir na página Fase Configurações do Assistente de Adicionar Fase no console: disponibilizar gradualmente esse software durante esse período de tempo (em dias).

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

-UserNotification

Este parâmetro é o mesmo da **** configuração a **** seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console: Especifique a configuração de experiência do usuário para essa implantação com os seguintes valores:

• DisplayAll: Exibir no Centro de Software e mostrar todas as notificações
• HideAll: Ocultar no Centro de Software e todas as notificações

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

-WriteFilterCommit

Esse parâmetro é o mesmo da **** configuração a **** seguir na página Experiência do Usuário do Assistente de Adicionar Fase no console: Confirmação de alterações no prazo ou durante uma janela de manutenção (requer reinicialização). Essa configuração se aplica ao tratamento de filtro de gravação para Windows dispositivos incorporados.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Links Relacionados

• Get-CMPhase
• New-CMTaskSequencePhase
• Get-CMTaskSequencePhasedDeployment
• New-CMTaskSequenceAutoPhasedDeployment
• New-CMTaskSequenceManualPhasedDeployment
• Remove-CMTaskSequencePhasedDeployment
• Set-CMTaskSequencePhasedDeployment
• Get-CMPhasedDeploymentStatus
• Move-CMPhasedDeploymentToNext
• Resume-CMPhasedDeployment
• Suspend-CMPhasedDeployment
• Criar implantações em fases