New-CMApplicationAutoPhasedDeployment

Artigo
08/12/2021

SYNOPSIS

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

SYNTAX

SearchByValueMandatory

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

SearchByIdMandatory

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

PesquisaByNameMandatory

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

A partir da versão 2002, utilize este cmdlet para criar uma implementação faseada para uma aplicação gerando duas fases com as mesmas definições. O comportamento deste cmdlet é o mesmo que o assistente de implementação faseada de uma aplicação, quando seleciona a opção para criar automaticamente uma implementação de duas fases predefinido.

Nota

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

EXAMPLES

Exemplo 1: Criar uma implementação por nome de aplicação

Este exemplo cria uma nova implementação faseada de aplicação chamada 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 de aplicação chamada myPDName para um objeto de aplicação canalizado.

$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"

PARAMETERS

-Aplicação

Especifique um objeto de aplicação para a implantação faseada.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-ApplicationId

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

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID

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

-Nome de aplicação

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

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: ApplicationLocalizedDisplayName

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

-Iniciar a Condição

Especificar 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 seguinte definição na página Definições do assistente de implantação faseada da consola: Inicie 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 de implantação faseada da consola: Iniciar manualmente a segunda fase.

Type: BeginConditionType
Parameter Sets: (All)
Aliases:
Accepted values: AfterPeriod, Manually

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-CritériosOpção

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

Compliance: Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente de implantação faseada da consola: Percentagem de sucesso da implementação. Especifique o valor percentual com o parâmetro CriteriaValue.
Number: Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente de implantação faseada da consola: Número de dispositivos implantados com sucesso. Especificar o número de dispositivos com o parâmetro CriteriaValue.

Type: CriteriaType
Parameter Sets: (All)
Aliases:
Accepted values: Compliance, Number

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

-CritériosValue

Este valor inteiro depende do valor que especifica para critérioOpoption:

Compliance: Especificar a percentagem
Number: Especificar o número de dispositivos

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
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 seguinte definição na página Definições do assistente de implementação faseada da consola: Inicie automaticamente esta fase após um período de diferimento (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Especifique o tipo de prazo. Utilize este parâmetro com o DeadlineValue.

Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

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

-PrazoSValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstalaçãoChoice.

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 de implantação faseada da consola: A instalação é necessária após este período de tempo.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PrimeiraCollecta

Especifique um objeto de recolha para a primeira fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Primeiro Nome deCollection

Especifique um nome de recolha para a primeira fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado. Não é recomendado. Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InstalaçãoChoice

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 seguinte definição na página Definições do assistente de implantação faseada da consola: 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 de implantação faseada da consola: A instalação é necessária após este período de tempo. Se especificar este valor, use a DeadlineUnit e a DeadlineValue para configurar o período de tempo.

Type: InstallationChoiceType
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, AfterPeriod

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

-Name

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

Type: String
Parameter Sets: (All)
Aliases:

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

-SegundaCollectcão

Especifique um objeto de recolha para a segunda fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Segundo Nome deCollection

Especifique um nome de recolha para a segunda fase.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
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 este software. Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente de implementação faseada da consola: Gradualmente disponibilizar este software ao longo deste período de tempo (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.