Partilhar via


New-CMTaskSequencePhase

SYNOPSIS

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

SYNTAX

SearchByCollection

New-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-BeginCondition <BeginConditionType>] [-Collection] <IResultObject> [-Comments <String>]
 [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>]
 [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>] [-DeploymentOption <DeploymentOptionType>]
 [-InstallationChoice <InstallationChoiceType>] -PhaseName <String> [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-ThrottlingDays <Int32>] [-UserNotification <UserNotificationType>]
 [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByCollectionId

New-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionId] <String> [-Comments <String>]
 [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>]
 [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>] [-DeploymentOption <DeploymentOptionType>]
 [-InstallationChoice <InstallationChoiceType>] -PhaseName <String> [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-ThrottlingDays <Int32>] [-UserNotification <UserNotificationType>]
 [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchByCollectionName

New-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
 [-BeginCondition <BeginConditionType>] [-CollectionName] <String> [-Comments <String>]
 [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>] [-DaysAfterPreviousPhaseSuccess <Int32>]
 [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>] [-DeploymentOption <DeploymentOptionType>]
 [-InstallationChoice <InstallationChoiceType>] -PhaseName <String> [-PreDownload <Boolean>]
 [-SoftwareInstallation <Boolean>] [-ThrottlingDays <Int32>] [-UserNotification <UserNotificationType>]
 [-WriteFilterCommit <Boolean>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

A partir da versão 2002, utilize este cmdlet para criar uma fase de implantação para uma sequência de tarefas.

EXAMPLES

Exemplo 1: Criar uma fase de sequência de tarefas

Este exemplo cria uma fase de sequência de tarefas chamada MyTSPhase para a coleção chamada MyCollection.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

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: SearchByCollection
Aliases:

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

-CollectionId

Especifique a recolha do alvo por ID.

Type: String
Parameter Sets: SearchByCollectionId
Aliases:

Required: True
Position: 0
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: SearchByCollectionName
Aliases:

Required: True
Position: 0
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

-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

-FaseName

Especifique um nome para a fase.

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

Required: True
Position: Named
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

Nenhuma

OUTPUTS

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

NOTAS