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 percentagemNumber
: 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çãoDownloadAllContentLocallyBeforeStartingTaskSequence
: 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çõesHideAll
: 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-CMTaskSequencePhasedDeployment
Novo CMTaskSequenceAutoFatosedDeployment
Novo CMTaskSequenceManualPhasedDeployment
Remover-CMTaskSequenceDeployment