Set-CMTaskSequencePhase

Utilize este cmdlet para configurar uma fase de implementação para uma sequência de tarefas.

Sintaxe

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. Utilize este cmdlet para configurar uma fase de implementação para uma sequência de tarefas. Para obter mais informações, veja Criar implementações faseadas.

Exemplos

Exemplo 1: Alterar a coleção

Este exemplo altera a coleção para a segunda fase na implementação faseada da sequência de tarefas transmitida na linha de comandos.

$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. Seleciona a implementação faseada pelo respetivo ID e seleciona a fase pelo ID de coleção associado.

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

Exemplo 3: Configurar definições de fase

Este exemplo altera as definições de configuração 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 seguinte definição na página Pontos de Distribuição do Assistente para Adicionar Fase na consola do : Permitir que os clientes utilizem pontos de distribuição do grupo de limites do site predefinido.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowRemoteDP

Este parâmetro é o mesmo que a seguinte definição na página Pontos de Distribuição do Assistente para Adicionar Fase na consola do : quando não estiver disponível nenhum ponto de distribuição local, utilize um ponto de distribuição remoto.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowSystemRestart

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente para Adicionar Fase na consola: Reinício do sistema (se necessário para concluir a instalação). Esta definição aplica-se quando o prazo de instalação é atingido, para permitir que esta atividade seja efetuada fora da janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BeginCondition

Especifique uma opção para iniciar esta fase de implementação após o êxito da fase anterior:

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : Iniciar automaticamente esta fase após um período de diferimento (em dias). Se especificar este valor, utilize DaysAfterPreviousPhaseSuccess para configurar o período de tempo.

  • Manually: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : Iniciar manualmente esta fase de implementação.

Tipo:BeginConditionType
Valores aceitos:AfterPeriod, Manually
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Collection

Especificar um objeto para a coleção de destino

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique a coleção de destino por ID.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifique a coleção de destino por nome.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Comments

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CriteriaOption

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

  • Compliance: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola: Percentagem de êxito da implementação. Especifique o valor de percentagem com o parâmetro CriteriaValue .

  • Number: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola: Número de dispositivos implementados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue .

Tipo:CriteriaType
Valores aceitos:Compliance, Number
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CriteriaValue

Este valor inteiro depende do valor que especificar para CriteriaOption:

  • Compliance: especifique a percentagem

  • Number: especifique o número de dispositivos

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DaysAfterPreviousPhaseSuccess

Especifique um valor inteiro para o número de dias após o êxito da fase anterior para iniciar esta fase. Este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : Iniciar automaticamente esta fase após um período de diferimento (em dias).

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineUnit

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

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstallationChoice .

Especifique um valor inteiro para o período de tempo do prazo. Utilize o parâmetro DeadlineUnit para especificar o tipo de período: Hours, Days, , Weeks. Months Este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : a instalação é necessária após este período de tempo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentOption

Este parâmetro é o mesmo que a seguinte definição na página Pontos de Distribuição do Assistente para Adicionar Fase na consola do : selecione a opção de implementação a utilizar quando um cliente utiliza um ponto de distribuição de um grupo de limites de vizinhos ou o grupo de limites de site predefinido. Aceita os seguintes valores:

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: transfira conteúdo localmente quando necessário pela sequência de tarefas em execução
  • DownloadAllContentLocallyBeforeStartingTaskSequence: Transfira todos os conteúdos localmente antes de iniciar a sequência de tarefas
Tipo:DeploymentOptionType
Valores aceitos:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado. Não é recomendado. Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID da fase a configurar.

Tipo:String
Aliases:PhaseId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de implementação faseado que inclua a fase a configurar.

Tipo:IResultObject
Aliases:PhasedDeployment
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InstallationChoice

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

  • AsSoonAsPossible: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : a instalação é necessária o mais rapidamente possível.

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : a instalação é necessária após este período de tempo. Se especificar este valor, utilize DeadlineUnit e DeadlineValue para configurar o período de tempo.

Tipo:InstallationChoiceType
Valores aceitos:AsSoonAsPossible, AfterPeriod
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MovePhase

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

Tipo:ReorderType
Valores aceitos:MoveUp, MoveDown, MoveToOrder
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MoveToOrder

Quando definir o parâmetro -MovePhase como MoveToOrder, utilize este parâmetro para definir o índice específico.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique o nome da fase a configurar.

Tipo:String
Aliases:PhaseName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewCollection

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewCollectionId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewCollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewPhaseName

Utilize este parâmetro para mudar o nome da fase selecionada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Order

Especifique o índice da fase a configurar.

Tipo:Int32
Aliases:PhaseOrder
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PhasedDeploymentId

Selecione a implementação faseada por ID. Em seguida, utilize outros parâmetros para selecionar a fase específica nessa implementação.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PhasedDeploymentName

Selecione a implementação faseada por nome. Em seguida, utilize outros parâmetros para selecionar a fase específica nessa implementação.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreDownload

Este parâmetro é o mesmo que a seguinte definição na página Geral do Assistente para Adicionar Fase na consola do : Pré-transferir conteúdo para esta sequência de tarefas.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareInstallation

Este parâmetro é o mesmo que a seguinte definição na página Experiência de Utilizador do Assistente para Adicionar Fase na consola: Instalação de Software. Esta definição aplica-se quando o prazo de instalação é atingido, para permitir que esta atividade seja efetuada fora da janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ThrottlingDays

Especifique um valor inteiro para o número de dias para disponibilizar gradualmente este software. Este parâmetro é o mesmo que a seguinte definição na página Definições de Fase do Assistente para Adicionar Fase na consola do : disponibilizar gradualmente este software ao longo deste período de tempo (em dias).

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserNotification

Este parâmetro é o mesmo que a seguinte definição na página Experiência de Utilizador do Assistente para Adicionar Fase na consola do : Especificar a definição de experiência de utilizador para esta implementação com os seguintes valores:

  • DisplayAll: apresentar no Centro de Software e mostrar todas as notificações
  • HideAll: Ocultar no Centro de Software e em todas as notificações
Tipo:UserNotificationType
Valores aceitos:DisplayAll, HideAll
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WriteFilterCommit

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente para Adicionar Fase na consola do : Consolidar alterações dentro do prazo ou durante uma janela de manutenção (requer reinício). Esta definição aplica-se ao processamento de filtros de escrita para dispositivos Windows Embedded.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject