Set-CMAutoDeploymentRuleDeployment

  • Riferimento
Modulo:
ConfigurationManager

Imposta una distribuzione per una regola di distribuzione automatica.

Sintassi

Set-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>]
   [-PassThru]
   [-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>]
Set-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>]
   [-PassThru]
   [-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 Set-CMAutoDeploymentRuleDeployment aggiorna una distribuzione per una regola di distribuzione automatica.

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: Impostare una distribuzione in base all'ID

PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -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

Questo comando aggiorna le impostazioni per la distribuzione della regola di distribuzione con l'ID azione 348 e la raccolta denominata Tutti i sistemi.

Esempio 2: Impostare una distribuzione usando una variabile

PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -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

Il primo comando ottiene l'oggetto regola di distribuzione automatica denominato TestADR01 e archivia l'oggetto nella variabile $ReferenceADR.

Il secondo comando ottiene le distribuzioni associate all'oggetto regola di distribuzione automatica archiviato in $ReferenceADR e archivia le distribuzioni nella variabile $Deployment.

L'ultimo comando aggiorna le impostazioni per la prima distribuzione archiviata in $Deployment.

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. I valori validi sono:

  • Ore
  • Giorni
  • Settimane
  • Mesi
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. I valori validi sono:

  • Ore
  • Giorni
  • Settimane
  • Mesi
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. I valori validi sono:

  • Ore
  • Giorni
  • Settimane
  • Mesi
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, è necessario distribuire manualmente il gruppo di aggiornamenti 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 azione della distribuzione automatica della regola di distribuzione.

Tipo:Int32
Alias:ActionID
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. Per ottenere un oggetto regola di distribuzione automatica, usare il cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

Tipo:IResultObject
Alias:AutoDeploymentRuleDeployment
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
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, della 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. I valori validi sono:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
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. I valori validi sono:

  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
  • AllMessages
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