New-CMSoftwareUpdatePhase

Riferimento

Modulo:: ConfigurationManager

Usare questo cmdlet per creare una fase di distribuzione per l'aggiornamento software.

Sintassi

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdatePhase
   [-AlertDelta <Int32>]
   [-AlertThresholdPercentage <Int32>]
   [-AlertUnit <TimeUnitType>]
   [-AllowMeteredConnection <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-AllowWumuFallback <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DisableScomAlert <Boolean>]
   [-EnableAlert <Boolean>]
   [-EnableWakeOnLan <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InstallationChoice <InstallationChoiceType>]
   [-PhaseDescription <String>]
   -PhaseName <String>
   [-RequirePostRebootFullScan <Boolean>]
   [-ServerRestartSuppression <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-StateMessageVerbosity <VerbosityLevelType>]
   [-ThrottlingDays <Int32>]
   [-UseNeighborDP <Boolean>]
   [-UserNotificationOption <UserNotificationType>]
   [-UseSiteDefaultDP <Boolean>]
   [-WorkstationRestartSuppression <Boolean>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una fase di distribuzione per l'aggiornamento software.

Esempio

Esempio 1: Creare una fase di aggiornamento software

In questo esempio viene creata una fase di aggiornamento software denominata MySUPhase per la raccolta denominata MyCollection che verrà visualizzata solo in Software Center.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase" `
 -UserNotificationOption DisplaySoftwareCenterOnly

Parametri

-AlertDelta

Questo parametro è uguale all'impostazione seguente nella pagina Avvisidell'Aggiunta guidata fase nella console: Scostamento dall'ora di scadenza. Specificare un valore intero per l'offset e quindi specificare il tipo di punto con il parametro AlertUnit .

Per impostare questo valore, è necessario usare il parametro EnableAlert .

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

-AlertThresholdPercentage

Questo parametro è identico all'impostazione seguente nella pagina Avvisi dell'Aggiunta guidata fase nella console: La conformità del client è inferiore alla seguente (percentuale).This parameter is same as the following setting on the Alerts page of the Add Phase Wizard in the console: Client compliance is below the following (percent). Specificare un valore intero per la percentuale. Per impostare questo valore, è necessario usare il parametro EnableAlert .

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

-AlertUnit

Specificare il tipo di punto. Usare questo parametro con AlertDelta.

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

-AllowMeteredConnection

Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni downloaddell'Aggiunta guidata fase nella console: Consentire ai client in una connessione Internet a consumo di scaricare il contenuto dopo la scadenza dell'installazione, con costi aggiuntivi.

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

-AllowSystemRestart

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Riavvio del sistema (se necessario per completare l'installazione). Questa impostazione si applica quando viene raggiunta la scadenza dell'installazione, per consentire l'esecuzione di questa attività all'esterno della finestra di manutenzione.

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

-AllowWumuFallback

Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni downloaddell'Aggiunta guidata fase nella console: se gli aggiornamenti software non sono disponibili nel punto di distribuzione nei gruppi di limiti correnti, adiacenti o del sito, scaricare il contenuto da Microsoft Updates.

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

-BeginCondition

Specificare un'opzione per iniziare questa fase di distribuzione dopo l'esito positivo della fase precedente:

AfterPeriod: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase 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 fasedell'Aggiunta guidata fase nella console: Iniziare manualmente questa fase di distribuzione.

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

-Collection

Specificare un oggetto per la raccolta di destinazione.

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

-CollectionId

Specificare la raccolta di destinazione in base all'ID.

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

-CollectionName

Specificare la raccolta di destinazione in base al nome.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
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 fase precedente:

Compliance: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase 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 fasedell'Aggiunta guidata fase 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 successivi all'esito positivo della fase precedente per iniziare questa fase. Questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase 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 fasedell'Aggiunta guidata fase 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

-DisableScomAlert

Questo parametro è uguale all'impostazione seguente nella pagina Avvisidell'Aggiunta guidata fase nella console: Disabilitare gli avvisi di Operations Manager durante l'esecuzione degli aggiornamenti software.

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

-EnableAlert

Questo parametro è uguale all'impostazione seguente nella pagina Avvisidell'Aggiunta guidata fase nella console: Generare un avviso quando vengono soddisfatte le condizioni seguenti. Quando si imposta questo parametro $truesu , impostare anche i parametri seguenti:

AlertThresholdPercentage
AlertDelta

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

-EnableWakeOnLan

Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni di distribuzionedell'Aggiunta guidata fase nella console: Usare riattivazione LAN per riattivare i client per le distribuzioni necessarie.

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

-GenerateScomAlertOnFailure

Questo parametro è uguale all'impostazione seguente nella pagina Avvisidell'Aggiunta guidata fase nella console: Generare un avviso di Operations Manager quando l'installazione di un aggiornamento software non riesce.

Tipo:	Boolean
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 fasedell'Aggiunta guidata fase nella console: l'installazione è necessaria il prima possibile.
AfterPeriod: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase 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

-PhaseDescription

Specificare una descrizione per la fase.

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

-PhaseName

Specificare un nome per la descrizione.

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

-RequirePostRebootFullScan

Questo parametro è lo stesso dell'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: se qualsiasi aggiornamento in questa distribuzione richiede un riavvio del sistema, eseguire il ciclo di valutazione della distribuzione degli aggiornamenti dopo il riavvio.

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

-ServerRestartSuppression

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console. Eliminare il riavvio del sistema nei dispositivi seguenti: Server.

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

-SoftwareInstallation

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Installazione software. Questa impostazione si applica quando viene raggiunta la scadenza dell'installazione, per consentire l'esecuzione di questa attività all'esterno della finestra di manutenzione.

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

-StateMessageVerbosity

Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni distribuzionedell'Aggiunta guidata fase nella console: Livello di dettaglio messaggio di stato con i valori seguenti:

AllMessages: tutti i messaggi
OnlySuccessAndErrorMessages: solo messaggi di errore e esito positivo
OnlyErrorMessages: solo messaggi di errore

Tipo:	VerbosityLevelType
Valori accettati:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ThrottlingDays

Specificare un valore intero per il numero di giorni per rendere gradualmente disponibile questo software. Questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase 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

-UseNeighborDP

Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni downloaddell'Aggiunta guidata fase nella console: selezionare l'opzione di distribuzione da usare quando un client usa un punto di distribuzione da un gruppo di limiti adiacente o dal gruppo di limiti del sito predefinito. Specificare i valori seguenti:

$true: scaricare gli aggiornamenti software dal punto di distribuzione e installare
$false: non installare gli aggiornamenti software

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

-UserNotificationOption

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Specificare l'impostazione dell'esperienza utente per questa distribuzione con i valori seguenti:

DisplayAll: visualizza in Software Center e mostra tutte le notifiche
DisplaySoftwareCenterOnly: visualizza in Software Center e mostra solo le notifiche per i riavvii del computer
HideAll: nascondi in Software Center e tutte le notifiche

Tipo:	UserNotificationType
Valori accettati:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UseSiteDefaultDP

Questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni downloaddell'Aggiunta guidata fase nella console: quando gli aggiornamenti software non sono disponibili in alcun punto di distribuzione nel gruppo di limiti corrente o adiacente, il client può scaricare e installare gli aggiornamenti software dai punti di distribuzione nel gruppo di limiti predefinito del sito. Specificare i valori seguenti:

$true: scaricare e installare gli aggiornamenti software dai punti di distribuzione nel gruppo di limiti predefinito del sito
$false: non installare gli aggiornamenti software

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

-WorkstationRestartSuppression

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console. Eliminare il riavvio del sistema nei dispositivi seguenti: Workstation.

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

-WriteFilterCommit

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Eseguire il commit delle modifiche alla scadenza o durante una finestra di manutenzione (è necessario riavviare). Questa impostazione si applica alla gestione dei filtri di scrittura per i dispositivi Windows Embedded.

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

Input

None

Output

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase

Condividi tramite