Compartilhar via

New-CMApplicationAutoPhasedDeployment

  • Referência
Módulo:
ConfigurationManager

Utilize este cmdlet para criar uma implementação faseada para uma aplicação ao gerar duas fases com as mesmas definições.

Sintaxe

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

Utilize este cmdlet para criar uma implementação faseada para uma aplicação ao gerar duas fases com as mesmas definições. O comportamento deste cmdlet é o mesmo que o assistente Criar Implementação Faseada numa aplicação, quando seleciona a opção para Criar automaticamente uma implementação de duas fases predefinida.

Observação

Antes de criar uma implementação faseada, certifique-se de que distribui o conteúdo da aplicação para um ponto de distribuição.

Exemplos

Exemplo 1: Criar uma implementação pelo nome da aplicação

Este exemplo cria uma nova implementação faseada da aplicação com o nome myDPName para a aplicação 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 implementação por objeto de aplicação de entrada

Este exemplo cria uma nova implementação faseada da aplicação com o nome myPDName para um objeto de aplicação encaminhada.

$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 de aplicação para a implementação faseada.

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

-ApplicationId

Especifique um ID de aplicação para a implementação faseada.

Tipo:String
Aliases:CIId, CI_ID
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationName

Especifique um nome de aplicação para a implementação faseada.

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

-BeginCondition

Especifique uma opção para iniciar a segunda fase de implementação após o êxito da primeira fase:

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada 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 do assistente Criar Implementação Faseada na consola do : Iniciar manualmente a implementação da segunda fase.

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

-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 primeira fase:

  • Compliance: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada 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 do assistente Criar Implementação Faseada na consola do : 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 primeira fase para iniciar a segunda fase. Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada 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 do assistente Criar Implementação Faseada 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

-Description

Especifique uma descrição para a implementação faseada da aplicação.

Tipo:String
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

-FirstCollection

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FirstCollectionId

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

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

-FirstCollectionName

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

Tipo:String
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 do assistente Criar Implementação Faseada 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 do assistente Criar Implementação Faseada 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

-Name

Especifique um nome para a implementação faseada da aplicação.

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

-SecondCollection

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecondCollectionId

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

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

-SecondCollectionName

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

Tipo:String
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 do assistente Criar Implementação Faseada 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

-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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject