Compartilhar via

New-CMTaskSequencePhase

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

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

Exemplos

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

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

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

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:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique a coleção de destino por ID.

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

-CollectionName

Especifique a coleção de destino por nome.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
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

-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

-PhaseName

Especifique um nome para a fase.

Tipo:String
Aliases:Name
Cargo:Named
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

None

Saídas

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase