New-CMAutoDeploymentRuleDeployment

Riferimento

Modulo:: ConfigurationManager

Creare una distribuzione per una regola di distribuzione automatica.

Sintassi

New-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Name] <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Id] <Int32>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMAutoDeploymentRuleDeployment
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowDownloadFromMicrosoftUpdate <Boolean>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DisableOperationsManager <Boolean>]
   [-EnableDeployment <Boolean>]
   [-GenerateOperationsManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-InputObject] <IResultObject>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-RequirePostRebootFullScan <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationOption>]
   [-UseUtc <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-CMAutoDeploymentRuleDeployment crea una distribuzione per una regola di distribuzione automatica.The New-CMAutoDeploymentRuleDeployment cmdlet creates a deployment for an automatic deployment rule (ADR).

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Creare una distribuzione per una regola di distribuzione automatica in base al nome

Questo comando crea una distribuzione per la regola di distribuzione automatica TestDepRule01 e l'insieme All Systems .

New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false  -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer  $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false

Esempio 2: Creare una distribuzione per una regola di distribuzione automatica per oggetto

Questo comando ottiene l'oggetto regola di distribuzione automatica denominato TestDepRule02. Viene quindi utilizzato l'operatore della pipeline per passare l'oggetto a New-CMAutoDeploymentRuleDeployment, che crea una distribuzione per la regola di distribuzione automatica TestDepRule02 e l'insieme All Systems .

Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -CollectionName "All Systems" -EnableDeployment $true -SendWakeupPacket $false -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $false -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $false -AllowRestart $false -SuppressRestartServer $false -SuppressRestartWorkstation $false -WriteFilterHandling $false -GenerateSuccessAlert  $true -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $false -GenerateOperationsManagerAlert $false -NoInstallOnRemote $false -NoInstallOnUnprotected $false -UseBranchCache $false

Parametri

-AlertTime

Specifica il numero di unità di tempo per l'offset dalla scadenza.

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

-AlertTimeUnit

Specifica il tipo di unità di tempo per l'offset dalla scadenza.

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

-AllowDownloadFromMicrosoftUpdate

Usare questo parametro per impostare l'opzione seguente nella pagina Impostazioni di download delle impostazioni di distribuzione ADR: 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

-AllowRestart

Indica se è possibile eseguire un riavvio del sistema al di fuori di qualsiasi finestra di manutenzione definita quando viene raggiunta la scadenza dell'installazione.

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

Indica se l'installazione software può essere eseguita al di fuori di qualsiasi finestra di manutenzione definita quando viene raggiunta la scadenza dell'installazione.

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

-AllowUseMeteredNetwork

Usare questo parametro per impostare l'opzione seguente nella pagina Impostazioni di download delle impostazioni di distribuzione ADR: Consentire ai client in una connessione Internet a consumo di scaricare il contenuto dopo la scadenza dell'installazione, che potrebbe comportare costi aggiuntivi

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

-AvailableImmediately

Indica se gli aggiornamenti software sono disponibili per l'installazione appena possibile dopo l'esecuzione della regola.

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

-AvailableTime

Specifica il numero di unità di tempo per il tempo disponibile del software.

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

-AvailableTimeUnit

Specifica il tipo di unità di tempo per il tempo disponibile del software.

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

-Collection

Specifica un oggetto raccolta di destinazione per la distribuzione dell'aggiornamento software. Per ottenere un oggetto raccolta, usare il cmdlet Get-CMCollection .

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

-CollectionId

Specifica l'ID della raccolta di destinazione per la distribuzione dell'aggiornamento software.

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

-CollectionName

Specifica il nome della raccolta di destinazione per la distribuzione dell'aggiornamento software.

Tipo:	String
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:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DeadlineImmediately

Indica se gli aggiornamenti software necessari vengono installati il prima possibile quando viene raggiunta la scadenza.

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

-DeadlineTime

Specifica il numero di unità di tempo per la scadenza.

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

-DeadlineTimeUnit

Specifica il tipo di unità di tempo per la scadenza.

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

-DisableOperationsManager

Indica se gli avvisi di Operations Manager sono disabilitati durante l'esecuzione degli aggiornamenti software.

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

-EnableDeployment

Indica se abilitare la distribuzione dopo l'esecuzione di questa regola per il gruppo software associato. Se impostato su $False, distribuire manualmente il gruppo di aggiornamento software.

Tipo:	Boolean
Alias:	Enable, EnabledAfterCreate, EnableAfterCreate
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 consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-GenerateOperationsManagerAlert

Indica se gli avvisi di Operations Manager vengono generati quando l'installazione di un aggiornamento software non riesce.

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

-GenerateSuccessAlert

Indica se viene generato un avviso quando questa regola viene eseguita correttamente.

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

-Id

Specifica l'ID della regola di distribuzione automatica a cui aggiungere la distribuzione.

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

-InputObject

Specifica un oggetto regola di distribuzione automatica a cui aggiungere la distribuzione. Per ottenere un oggetto regola di distribuzione automatica, usare il cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

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

-Name

Specifica il nome della regola di distribuzione automatica a cui aggiungere la distribuzione.

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

-NoInstallOnRemote

Indica se installare gli aggiornamenti software quando gli aggiornamenti non sono disponibili in alcun punto di distribuzione remoto.

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

-NoInstallOnUnprotected

Indica se installare gli aggiornamenti software quando gli aggiornamenti non sono disponibili in punti di distribuzione non protetti.

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

-RequirePostRebootFullScan

Usare questo parametro per impostare l'opzione seguente nella pagina Esperienza utente delle impostazioni di distribuzione di ADR: 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
Alias:	RunEvaluationAfterRestart
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SendWakeupPacket

Indica se usare la riattivazione LAN per riattivare i client per le distribuzioni necessarie.

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

-SoftDeadlineEnabled

Usare questo parametro per impostare l'opzione seguente nella pagina Pianificazione distribuzione delle impostazioni di distribuzione ADR: Ritardare l'imposizione di questa distribuzione in base alle preferenze dell'utente, fino al periodo di tolleranza definito nelle impostazioni client.

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

-SuccessPercentage

Specifica la percentuale come numero intero di conformità client. Quando la conformità del client scende al di sotto di questa percentuale, viene generato un avviso.

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

-SuppressRestartServer

Indica se un riavvio del sistema viene eliminato nei server quando un aggiornamento software richiede un riavvio del sistema per completare il processo di installazione.

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

-SuppressRestartWorkstation

Indica se un riavvio del sistema viene eliminato nelle workstation quando un aggiornamento software richiede un riavvio del sistema per completare il processo di installazione.

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

-UseBranchCache

Indica se ai client è consentito condividere contenuto con altri client nella stessa subnet.

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

-UserNotification

Specifica il comportamento di notifica dell'esperienza visiva utente.

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

-UseUtc

Indica se la pianificazione per questa distribuzione viene valutata in base all'ora UTC (Universal Coordinated Time).

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

-VerboseLevel

Specifica la quantità di dettagli sullo stato restituiti dai client per le distribuzioni create da questa regola.

Tipo:	VerboseLevelType
Valori accettati:	OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WriteFilterHandling

Indica se il commit delle modifiche viene eseguito alla scadenza o durante una finestra di manutenzione (richiede riavvii). Se impostato su $False, il contenuto viene applicato alla sovrimpressione e ne viene eseguito il commit in un secondo momento.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Condividi tramite