New-CMTaskSequencePhase

Módulo:

ConfigurationManager

Use esse cmdlet para criar uma fase de implantação para uma sequência de tarefas.

Syntax

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

Use esse cmdlet para criar uma fase de implantaçã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 chamada MyTSPhase para a coleção chamada MyCollection.

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

Parâmetros

-AllowFallback

Esse parâmetro é o mesmo que a seguinte configuração na página Pontos de Distribuição do Assistente de Fase de Adição no console: permitir que os clientes usem pontos de distribuição do grupo de limites do site padrão.

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

-AllowRemoteDP

Esse parâmetro é o mesmo que a seguinte configuração na página Pontos de Distribuição do Assistente de Fase de Adição no console: quando nenhum ponto de distribuição local estiver disponível, use um ponto de distribuição remoto.

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

-AllowSystemRestart

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Adicionar Fase no console: Reinicialização do sistema (se necessário para concluir a instalação). Essa configuração se aplica quando o prazo de instalação é atingido, para permitir que essa atividade seja executada fora da janela de manutenção.

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

-BeginCondition

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

• AfterPeriod: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: inicie automaticamente essa fase após um período de adiamento (em dias). Se você especificar esse valor, use DaysAfterPreviousPhaseSuccess para configurar o período de tempo.

• Manually: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: inicie manualmente essa fase de implantação.

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

Especificar um objeto para a coleção de destino

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

-CollectionId

Especifique a coleção de destino por ID.

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

-CollectionName

Especifique a coleção de destino pelo nome.

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

-Comments

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaOption

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

• Compliance: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: percentual de sucesso da implantação. Especifique o valor percentual com o parâmetro CriteriaValue .

• Number: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: número de dispositivos implantados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue .

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

Esse valor inteiro depende do valor que você especifica para CriteriaOption:

• Compliance: especifique o percentual

• Number: especifique o número de dispositivos

Type:	Int32
Position:	Named
Default value:	None
Required:	False
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 essa fase. Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: inicie automaticamente essa fase após um período de adiamento (em dias).

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

-DeadlineUnit

Especifique o tipo de período de prazo. Use esse parâmetro com DeadlineValue.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

Esse parâmetro só será usado se você especificar AfterPeriod com o parâmetro InstallationChoice .

Especifique um valor inteiro para o período de tempo do prazo. Use o parâmetro DeadlineUnit para especificar o tipo de período: Hours, , Days, Weeks. Months Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: a instalação é necessária após esse período de tempo.

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

-DeploymentOption

Esse parâmetro é o mesmo que a seguinte configuração na página Pontos de Distribuição do Assistente de Fase de Adição no console: selecione a opção de implantação a ser usada quando um cliente usa um ponto de distribuição de um grupo de limites vizinho ou do grupo de limites do site padrão. Ele aceita os seguintes valores:

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

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado. Não é recomendável. Você não pode combiná-lo com DisableWildcardHandling.

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

-InstallationChoice

Especifique uma opção para o comportamento relativo a quando o software é disponibilizado:

• AsSoonAsPossible: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: a instalação é necessária o mais rápido possível.

• AfterPeriod: esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: a instalação é necessária após esse período de tempo. Se você especificar esse valor, use DeadlineUnit e DeadlineValue para configurar o período de tempo.

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PhaseName

Especifique um nome para a fase.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PreDownload

Esse parâmetro é o mesmo que a seguinte configuração na página Geral do Assistente de Fase de Adição no console: Pré-baixar conteúdo para esta sequência de tarefas.

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

-SoftwareInstallation

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: Instalação de Software. Essa configuração se aplica quando o prazo de instalação é atingido, para permitir que essa atividade seja executada fora da janela de manutenção.

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

-ThrottlingDays

Especifique um valor inteiro para o número de dias para disponibilizar gradualmente esse software. Esse parâmetro é o mesmo que a seguinte configuração na página Configurações de Fase do Assistente de Fase de Adição no console: disponibilize gradualmente esse software durante esse período de tempo (em dias).

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

-UserNotification

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: especifique a configuração de experiência do usuário para essa implantação com os seguintes valores:

• DisplayAll: exibir no Centro de Software e mostrar todas as notificações
• HideAll: Ocultar no Centro de Software e todas as notificações

Type:	UserNotificationType
Accepted values:	DisplayAll, HideAll
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WriteFilterCommit

Esse parâmetro é o mesmo que a seguinte configuração na página Experiência do Usuário do Assistente de Fase de Adição no console: Confirmar alterações no prazo ou durante uma janela de manutenção (requer reinicialização). Essa configuração se aplica ao tratamento de filtro de gravação para dispositivos Windows Embedded.

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

Entradas

None

Saídas

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase