Set-CMTaskSequencePhase

SYNOPSIS

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

SYNTAX

SearchByPhasedDeployment

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>]

SearchByPhasedDeploymentId

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>]

SearchByPhasedDeployme

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

EXAMPLES

Exemplo 1: Alterar a coleção

Este exemplo altera a recolha para a segunda fase na sequência de tarefas de implantação faseada 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. Seleciona a implementação faseada pelo seu ID e seleciona a fase pelo ID de recolha associado.

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

Exemplo 3: Configurações de fase de configuração

Este exemplo altera as definições de configuração para a 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

PARAMETERS

-Permitir o Retorno

Este parâmetro é o mesmo que a seguinte definição na página pontos de distribuição do Assistente de Fase de Adicionar na consola: Permitir que os clientes utilizem pontos de distribuição a partir do grupo de fronteira do site padrão.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Permitir ReotetarDP

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PermitirSystemRestart

Este parâmetro é o mesmo que a seguinte definição na página Experiência do Utilizador do Assistente de Fase de Adicionar na consola: Reiniciar o 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 executada fora da janela de manutenção.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Iniciar a Condição

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

• AfterPeriod: Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Inicie 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 fase Definições do Assistente de Fase de Adição na consola: Iniciar manualmente esta fase de implantação.

Type: BeginConditionType
Parameter Sets: (All)
Aliases:
Accepted values: AfterPeriod, Manually

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

-Coleção

Especificar um objeto para a coleção de destino

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Especifique a recolha do alvo por ID.

Type: String
Parameter Sets: (All)
Aliases:

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

-Nome de coleção

Especifique a recolha do alvo pelo nome.

Type: String
Parameter Sets: (All)
Aliases:

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

-Comentários

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-CritériosOpção

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

• Compliance: Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Percentagem de sucesso de implementação. Especifique o valor percentual com o parâmetro CriteriaValue.

• Number: Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Número de dispositivos implantados com sucesso. Especificar o número de dispositivos com o parâmetro CriteriaValue.

Type: CriteriaType
Parameter Sets: (All)
Aliases:
Accepted values: Compliance, Number

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

-CritériosValue

Este valor inteiro depende do valor que especifica para critérioOpoption:

• Compliance: Especificar a percentagem

• Number: Especificar o número de dispositivos

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
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 esta fase. Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Inicie automaticamente esta fase após um período de diferimento (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

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

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-PrazoSValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstalaçãoChoice.

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 fase Definições do Assistente de Fase de Adição na consola: A instalação é necessária após este período de tempo.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeploymentOption

Este parâmetro é o mesmo que a seguinte definição na página pontos de distribuição do Assistente de Fase de Adicionar na consola: Selecione a opção de implementação a utilizar quando um cliente utiliza um ponto de distribuição a partir de um grupo de fronteira do vizinho ou do grupo de fronteira do local padrão. Aceita os seguintes valores:

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

Type: DeploymentOptionType
Parameter Sets: (All)
Aliases:
Accepted values: DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- ID

Especifique o ID da fase para configurar.

Type: String
Parameter Sets: (All)
Aliases: PhaseId

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

-InputObject

Especifique um objeto de implantação faseada que inclua a fase de configuração.

Type: IResultObject
Parameter Sets: SearchByPhasedDeployment
Aliases: PhasedDeployment

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-InstalaçãoChoice

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 seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: A instalação é necessária o mais rapidamente possível.

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

Type: InstallationChoiceType
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, AfterPeriod

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

-MovePhase

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

Type: ReorderType
Parameter Sets: (All)
Aliases:
Accepted values: MoveUp, MoveDown, MoveToOrder

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

-MoveToOrder

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

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Name

Especifique o nome da fase para configurar.

Type: String
Parameter Sets: (All)
Aliases: PhaseName

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

-NovaCollection

Especifique um objeto de recolha para usar como novo alvo para a fase selecionada.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-NewCollectionId

Especifique uma recolha por ID para usar como o novo alvo para a fase selecionada.

Type: String
Parameter Sets: (All)
Aliases:

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

-Novo Nome deCollection

Especifique uma coleção pelo nome para usar como o novo alvo para a fase selecionada.

Type: String
Parameter Sets: (All)
Aliases:

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

-NewPhaseName

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Ordem

Especifique o índice da fase para configurar.

Type: Int32
Parameter Sets: (All)
Aliases: PhaseOrder

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

-DeploymentId faseado

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

Type: String
Parameter Sets: SearchByPhasedDeploymentId
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FasedoDeploymentName

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

Type: String
Parameter Sets: SearchByPhasedDeploymentName
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Pré-Download

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Instalação de Software

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

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
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 este software. Este parâmetro é o mesmo que a seguinte definição na página fase Definições do Assistente de Fase de Adição na consola: Gradualmente disponibilizar este software durante este período de tempo (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Notificação do Utilizador

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

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

Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, HideAll

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-WriteFilterCommit

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_PhasedDeployment

NOTAS

RELATED LINKS

Get-CMPhase

Nova CMTaskSequencePhase

Get-CMTaskSequencePhasedDeployment

Novo CMTaskSequenceAutoFatosedDeployment

Novo CMTaskSequenceManualPhasedDeployment

Remover-CMTaskSequenceDeployment

Set-CMTaskSequencePhasedDeployment

Get-CMPhasedDeploymentStatus

Move-CMPhasedDeploymentToNext

Resumo-CMPhasedDeployment

Suspender-CMPhasedDeployment

Criar implementações faseadas