New-CMSoftwareUpdateAutoPhasedDeployment
Utilizzare 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
Utilizzare 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 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 in 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 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 in base all'oggetto di aggiornamento di input
In questo esempio viene creata una nuova distribuzione in 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. È inoltre possibile aggiungere altre fasi con questo parametro. Specificare una matrice di fasi. Usa New-CMSoftwareUpdatePhase per creare le fasi.
Type: | Phase[] |
Position: | Named |
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 percentualeNumber
: 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 fasi dell'aggiornamento software.
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 |
-InsertAtOrder
Se si utilizza il parametro AddPhases, utilizzare questo parametro per determinare il punto in cui inserire le fasi aggiuntive nell'ordine delle fasi. Specificare un numero intero con il numero di ordine.
Type: | Int32 |
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 |
-SoftwareUpdateGroup
Specificare un oggetto per il gruppo di aggiornamento software.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SoftwareUpdateGroupId
Specificare il gruppo di aggiornamento software in base all'ID.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroupName
Specificare il gruppo di aggiornamento software in base al nome.
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateIds
Specificare una matrice di ID aggiornamento software.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateNames
Specificare una matrice di nomi di aggiornamento software.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdates
Specificare una matrice di oggetti di aggiornamento software.
Type: | IResultObject[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
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
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Output
IResultObject