Share via

New-CMTaskSequenceAutoPhasedDeployment

  • Referência
Módulo:
ConfigurationManager

Use este cmdlet para criar uma implantação em fases para uma sequência de tarefas gerando duas fases com as mesmas configurações.

Syntax

New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequence] <IResultObject>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequenceId] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequenceAutoPhasedDeployment
   [-TaskSequenceName] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para criar uma implantação em fases para uma sequência de tarefas gerando duas fases com as mesmas configurações. O comportamento desse cmdlet é **** o mesmo do assistente Criar Implantação em Fases em uma sequência de tarefas, quando você seleciona a opção para criar automaticamente uma implantação de duas fases padrão.

Observação

Antes de criar uma implantação em fases, certifique-se de distribuir o conteúdo da sequência de tarefas para um ponto de distribuição.

Exemplos

Exemplo 1: Criar uma implantação pelo nome da sequência de tarefas

Este exemplo cria uma nova implantação em fases de sequência de tarefas chamada myDPName para a sequência de tarefas myTaskSequenceName.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Exemplo 2: Criar uma implantação por objeto de sequência de tarefas de entrada

Este exemplo cria uma nova implantação em fases de sequência de tarefas chamada myPDName para um objeto de sequência de tarefas canalizada.

$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Parâmetros

-AddPhases

Esse cmdlet cria automaticamente duas fases para as duas coleções especificadas. Você também pode adicionar mais fases com esse parâmetro. Especifique uma matriz de fases. Use New-CMTaskSequencePhase para criar as fases.

Type:Phase[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-BeginCondition

Especifique uma opção para iniciar a segunda fase de implantação após o sucesso da primeira fase:

  • AfterPeriod: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente criar implantação em fases 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: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: Iniciar manualmente a implantação da segunda fase.

Type:BeginConditionType
Accepted values:AfterPeriod, Manually
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-CriteriaOption

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

  • Compliance: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: Porcentagem de sucesso de implantação. Especifique o valor percentual com o parâmetro CriteriaValue.

  • Number: Este parâmetro é o mesmo que a seguinte **** configuração na página Configurações do assistente Criar Implantação em Fases 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
Accept pipeline input:False
Accept wildcard characters:False

-CriteriaValue

Esse valor inteiro depende do valor especificado para CriteriaOption:

  • Compliance: Especifique a porcentagem

  • Number: Especifique o número de dispositivos

Type:Int32
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 primeira fase para iniciar a segunda fase. Este parâmetro é o mesmo que a configuração a **** seguir na página Configurações do assistente Criar Implantação em Fases no console: Inicie automaticamente essa fase após um período de adiamento (em dias).

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

-DeadlineUnit

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

Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
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 limite. Use o parâmetro DeadlineUnit para especificar o tipo de ponto: Hours , , , Days Weeks Months . Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente criar implantação em fases no console: a instalação é necessária após esse período de tempo.

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

-Description

Especifique uma descrição para a implantação em fases da sequência de tarefas.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-FirstCollection

Especifique um objeto de coleção para a primeira fase.

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

-FirstCollectionId

Especifique uma ID de coleção para a primeira fase.

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

-FirstCollectionName

Especifique um nome de coleção para a primeira fase.

Type:String
Position:Named
Default value:None
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. Não é possível combiná-lo com DisableWildcardHandling.

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

-InsertAtOrder

Se você usar o parâmetro AddPhases, use esse parâmetro para determinar onde, na ordem das fases, inserir as fases adicionais. Especifique um inteiro com o número do pedido.

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

-InstallationChoice

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 configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: a instalação é necessária assim que possível.

  • AfterPeriod: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases 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
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique um nome para a implantação em fases da sequência de tarefas.

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

-SecondCollection

Especifique um objeto de coleção para a segunda fase.

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

-SecondCollectionId

Especifique uma ID de coleção para a segunda fase.

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

-SecondCollectionName

Especifique um nome de coleção para a segunda fase.

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

-TaskSequence

Especifique um objeto de sequência de tarefas.

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

-TaskSequenceId

Especifique uma sequência de tarefas por ID.

Type:String
Aliases:TaskSequencePackageId
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceName

Especifique uma sequência de tarefas por nome.

Type:String
Position:0
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 esse software. Esse parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente criar implantação em fases no console: disponibilizar gradualmente esse software durante esse período de tempo (em dias).

Type:Int32
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject