New-CMSoftwareUpdateAutoPhasedDeployment

Riferimento

Modulo:: ConfigurationManager

Usare questo cmdlet per creare una distribuzione in più fasi per gli aggiornamenti software generando due fasi con le stesse impostazioni.

Sintassi

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroup] <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-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupId] <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-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupName] <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-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateIds] <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-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateNames] <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-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdates] <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>]

Descrizione

Usare questo cmdlet per creare una distribuzione in più fasi per gli aggiornamenti software generando due fasi con le stesse impostazioni. Il comportamento di questo cmdlet è lo stesso della procedura guidata Crea distribuzione in più fasi in un aggiornamento software 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'aggiornamento software a un punto di distribuzione.

Esempio

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

In questo esempio viene creata una nuova distribuzione in più fasi di aggiornamento software denominata myDPName per l'aggiornamento software myUpdateName.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -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 tramite l'oggetto di aggiornamento di input

In questo esempio viene creata una nuova distribuzione in più fasi di aggiornamento software denominata myPDName per un oggetto di aggiornamento software con pipe.

$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -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

-AddPhases

Questo cmdlet crea automaticamente due fasi per le due raccolte specificate. È anche possibile aggiungere altre fasi con questo parametro. Specificare una matrice di fasi. Usare New-CMSoftwareUpdatePhase per creare le fasi.

Tipo:	Phase[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BeginCondition

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

AfterPeriod: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi nella console: iniziare automaticamente questa fase dopo un periodo di differimento (in giorni). Se si specifica questo valore, usare DaysAfterPreviousPhaseSuccess per configurare il periodo di tempo.
Manually: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi nella console: Iniziare manualmente la distribuzione della seconda fase.

Tipo:	BeginConditionType
Valori accettati:	AfterPeriod, Manually
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CriteriaOption

Specificare un'opzione per scegliere i criteri per l'esito positivo della prima fase:

Compliance: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi nella console: Percentuale di esito positivo della distribuzione. Specificare il valore percentuale con il parametro CriteriaValue .
Number: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi nella console: Numero di dispositivi distribuiti correttamente. Specificare il numero di dispositivi con il parametro CriteriaValue .

Tipo:	CriteriaType
Valori accettati:	Compliance, Number
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CriteriaValue

Questo valore intero dipende dal valore specificato per CriteriaOption:

Compliance: specificare la percentuale
Number: specificare il numero di dispositivi

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 è lo stesso dell'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi nella console: iniziare automaticamente questa fase dopo un periodo di differimento (in giorni).

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DeadlineUnit

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

Tipo:	TimeUnitType
Valori accettati:	Hours, Days, Weeks, Months
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 punto: Hours, Days, Weeks, Months. Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della Creazione guidata distribuzione in più fasi nella console: l'installazione è necessaria dopo questo periodo di tempo.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisableWildcardHandling

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FirstCollection

Specificare un oggetto raccolta per la prima fase.

Tipo:	IResultObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FirstCollectionId

Specificare un ID raccolta per la prima fase.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FirstCollectionName

Specificare un nome di raccolta per la prima fase.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ForceWildcardHandling

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InsertAtOrder

Se si usa il parametro AddPhases , usare questo parametro per determinare dove, nell'ordine delle fasi, inserire le fasi aggiuntive. Specificare un numero intero con il numero di ordine.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InstallationChoice

Specificare un'opzione per il comportamento relativo a quando il software viene reso disponibile:

AsSoonAsPossible: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della Creazione guidata distribuzione in più fasi nella console: l'installazione è necessaria il prima possibile.
AfterPeriod: questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni della Creazione guidata distribuzione in più fasi nella console: l'installazione è necessaria dopo questo periodo di tempo. Se si specifica questo valore, usare DeadlineUnit e DeadlineValue per configurare il periodo di tempo.

Tipo:	InstallationChoiceType
Valori accettati:	AsSoonAsPossible, AfterPeriod
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecondCollection

Specificare un oggetto raccolta per la seconda fase.

Tipo:	IResultObject
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecondCollectionId

Specificare un ID raccolta per la seconda fase.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecondCollectionName

Specificare un nome di raccolta per la seconda fase.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftwareUpdateGroup

Specificare un oggetto per il gruppo di aggiornamento software.

Tipo:	IResultObject
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-SoftwareUpdateGroupId

Specificare il gruppo di aggiornamento software in base all'ID.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftwareUpdateGroupName

Specificare il gruppo di aggiornamento software in base al nome.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftwareUpdateIds

Specificare una matrice di ID di aggiornamento software.

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftwareUpdateNames

Specificare una matrice di nomi di aggiornamento software.

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftwareUpdates

Specificare una matrice di oggetti di aggiornamento software.

Tipo:	IResultObject[]
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ThrottlingDays

Specificare un valore intero per il numero di giorni per rendere gradualmente disponibile questo software. Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi nella console: rendere gradualmente disponibile il software in questo periodo di tempo (in giorni).

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Output

IResultObject

Condividi tramite