New-CMApplicationAutoPhasedDeployment

  • Riferimento
Modulo:
ConfigurationManager

Utilizzare questo cmdlet per creare una distribuzione in più fasi per un'applicazione generando due fasi con le stesse impostazioni.

Sintassi

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

Descrizione

Utilizzare questo cmdlet per creare una distribuzione in più fasi per un'applicazione generando due fasi con le stesse impostazioni. Il comportamento di questo cmdlet **** è lo stesso della procedura guidata Crea distribuzione in fasi in un'applicazione, quando si seleziona l'opzione crea automaticamente una distribuzione a due fasi predefinita.

Nota

Prima di creare una distribuzione in più fasi, assicurarsi di distribuire il contenuto dell'applicazione in un punto di distribuzione.

Esempio

Esempio 1: Creare una distribuzione in base al nome dell'app

In questo esempio viene creata una nuova distribuzione in fasi dell'applicazione denominata myDPName per l'applicazione 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"

Esempio 2: Creare una distribuzione in base all'oggetto app di input

In questo esempio viene creata una nuova distribuzione in fasi dell'applicazione denominata myPDName per un oggetto applicazione con pipe.

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

Parametri

-Application

Specificare un oggetto applicazione per la distribuzione in più fasi.

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

-ApplicationId

Specificare un ID applicazione per la distribuzione in più fasi.

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

-ApplicationName

Specificare un nome di applicazione per la distribuzione in più fasi.

Type:String
Aliases:ApplicationLocalizedDisplayName
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-BeginCondition

Specificare un'opzione per l'inizio della seconda fase di distribuzione dopo l'esito positivo della prima fase:

  • AfterPeriod: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni **** della procedura guidata Crea distribuzione in fasi nella console: avvia automaticamente questa fase dopo un periodo di differimento (in giorni). Se si specifica questo valore, utilizzare DaysAfterPreviousPhaseSuccess per configurare il periodo di tempo.

  • Manually: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni della procedura guidata Crea distribuzione in fasi nella console: Avviare manualmente la distribuzione della seconda fase. ****

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-CriteriaOption

Specificare un'opzione per scegliere i criteri per il successo della prima fase:

  • Compliance: questo parametro corrisponde all'impostazione seguente nella pagina **** Impostazioni della procedura guidata Crea distribuzione in fasi nella console: Percentuale di successo della distribuzione. Specificare il valore percentuale con il parametro CriteriaValue.

  • Number: questo parametro corrisponde all'impostazione seguente nella pagina **** Impostazioni della procedura guidata Crea distribuzione in fasi nella console: Numero di dispositivi distribuiti correttamente. Specifica il numero di dispositivi con il parametro CriteriaValue.

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

-CriteriaValue

Questo valore intero dipende dal valore specificato per CriteriaOption:

  • Compliance: specificare la percentuale

  • Number: specificare il numero di dispositivi

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

-DaysAfterPreviousPhaseSuccess

Specificare un valore intero per il numero di giorni dopo l'esito positivo della prima fase per iniziare la seconda fase. Questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni **** della procedura guidata Crea distribuzione in fasi nella console: avvia automaticamente questa fase dopo un periodo di differimento (in giorni).

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

-DeadlineUnit

Specificare il tipo di periodo di scadenza. Utilizzare questo parametro con DeadlineValue.

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

-DeadlineValue

Questo parametro viene utilizzato solo se si specifica AfterPeriod con il parametro InstallationChoice.

Specificare un valore intero per il periodo di tempo per la scadenza. Utilizzare il parametro DeadlineUnit per specificare il tipo di periodo: Hours , , , Days Weeks Months . Questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni della procedura guidata Crea distribuzione in fasi nella console: l'installazione è necessaria dopo questo periodo di tempo. ****

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

-Description

Specificare una descrizione per la distribuzione in più fasi dell'applicazione.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-FirstCollection

Specificare un oggetto insieme per la prima fase.

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

-FirstCollectionId

Specificare un ID raccolta per la prima fase.

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

-FirstCollectionName

Specificare un nome di raccolta per la prima fase.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto. Non è consigliabile. Non è possibile combinarlo con DisableWildcardHandling.

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

-InstallationChoice

Specificare un'opzione per il comportamento relativo alla disponibilità del software:

  • AsSoonAsPossible: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni **** della procedura guidata Crea distribuzione in fasi nella console: l'installazione è necessaria il prima possibile.

  • AfterPeriod: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni **** della procedura guidata Crea distribuzione in fasi nella console: l'installazione è necessaria dopo questo periodo di tempo. Se si specifica questo valore, utilizzare DeadlineUnit e DeadlineValue per configurare il periodo di tempo.

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

-Name

Specificare un nome per la distribuzione in più fasi dell'applicazione.

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

-SecondCollection

Specificare un oggetto insieme per la seconda fase.

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

-SecondCollectionId

Specificare un ID raccolta per la seconda fase.

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

-SecondCollectionName

Specificare un nome di raccolta per la seconda fase.

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

-ThrottlingDays

Specificare un valore intero per il numero di giorni per rendere gradualmente disponibile questo software. Questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni **** della procedura guidata Crea distribuzione in fasi nella console: Rendere gradualmente disponibile questo software in questo periodo di tempo (in giorni).

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject