Share via

New-CMApplicationAutoPhasedDeployment

  • Referência
Módulo:
ConfigurationManager

Use este cmdlet para criar uma implantação em fases para um aplicativo gerando duas fases com as mesmas configurações.

Syntax

New-CMApplicationAutoPhasedDeployment
   [-Application] <IResultObject>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
   [-ApplicationId] <String>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
   [-ApplicationName] <String>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-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 um aplicativo gerando duas fases com as mesmas configurações. O comportamento desse cmdlet é **** o mesmo do assistente Criar Implantação em Fases em um aplicativo, 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 do aplicativo para um ponto de distribuição.

Exemplos

Exemplo 1: Criar uma implantação pelo nome do aplicativo

Este exemplo cria uma nova implantação em fases de aplicativo chamada myDPName para o aplicativo myApp.

New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -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 aplicativo de entrada

Este exemplo cria uma nova implantação em fases de aplicativo chamada myPDName para um objeto de aplicativo canalizada.

$myApp | New-CMApplicationAutoPhasedDeployment -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

-Application

Especifique um objeto application para a implantação em fases.

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

-ApplicationId

Especifique uma ID de aplicativo para a implantação em fases.

Type:String
Aliases:CIId, CI_ID
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Especifique um nome de aplicativo para a implantação em fases.

Type:String
Aliases:ApplicationLocalizedDisplayName
Position:1
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 do aplicativo.

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

-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 do aplicativo.

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

-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