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 percentagemNumber
: 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
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 implementações faseadas