Condividi tramite


New-CMSoftwareUpdateAutoDeploymentRule

Creare una regola di distribuzione automatica (ADR) per gli aggiornamenti software.

Sintassi

New-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   -Collection <IResultObject>
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-IsServicingPlan]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   -CollectionId <String>
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-IsServicingPlan]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   -CollectionName <String>
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-IsServicingPlan]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-CMSoftwareUpdateAutoDeploymentRule crea una regola di distribuzione automatica per gli aggiornamenti software. Quando viene eseguita una regola, Configuration Manager aggiunge gli aggiornamenti idonei per la regola a un gruppo di aggiornamenti software. Il server di Configuration Manager scarica i file di contenuto e li copia nei punti di distribuzione e quindi aggiorna i computer client. Per altre informazioni, vedere Distribuire automaticamente gli aggiornamenti software.

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 un adr di base

Questo comando crea una regola di distribuzione denominata DeploymentRule07 per la raccolta denominata Desktops e il pacchetto di distribuzione denominato Updates123. La regola distribuisce gli aggiornamenti con un ID articolo che contiene 117.

New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"

Esempio 2: Creare un'istanza di Active Directory che usa una pianificazione e altre proprietà

In questo esempio viene creata una regola di distribuzione automatica che usa una pianificazione definita. La distribuzione viene eseguita in base alla pianificazione.

Il primo comando crea una pianificazione per mercoledì e archivia l'oggetto pianificazione nella variabile $Schedule . Per altre informazioni, vedere New-CMSchedule.

Il secondo comando crea una regola di distribuzione automatica per gli aggiornamenti che usano l'oggetto pianificazione archiviato nella variabile. Questo comando specifica i valori per molti parametri.

$Schedule = New-CMSchedule -DayOfWeek Wednesday

New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $True

Esempio 3: Creare un adr per più lingue

In questo esempio viene creato un adr che aggiunge i criteri di lingua per tre lingue: inglese, ungherese e cinese (semplificato, RPC). Aggiunge anche queste lingue per i file binari di aggiornamento di Windows e Office 365 da scaricare. Questa regola di esempio è disabilitata per impostazione predefinita.

New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"

Parametri

-AddToExistingSoftwareUpdateGroup

Indica se la regola viene aggiunta a un gruppo di aggiornamento software esistente.

  • Se questo valore è $True, ogni volta che la regola viene eseguita e trova nuovi aggiornamenti, vengono aggiunti a un gruppo di aggiornamenti esistente.
  • Se questo valore è $False, crea un nuovo gruppo di aggiornamento.

Specificare il gruppo di aggiornamento esistente o assegnare un nome per il nuovo gruppo di aggiornamento usando il parametro -DeploymentPackageName .

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

-AlertTime

Specifica un offset intero da una scadenza per la distribuzione degli aggiornamenti. La regola usa questo valore per specificare quando la regola genera avvisi. Specificare un'unità di tempo usando il parametro -AlertTimeUnit .

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

-AlertTimeUnit

Specifica un'unità di tempo per il parametro -AlertTime .

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

-AllowRestart

Indica se consentire il riavvio di un computer se la distribuzione dell'aggiornamento viene eseguita all'esterno di una finestra di manutenzione. Una finestra di manutenzione è un periodo di tempo specificato usato per la manutenzione e gli aggiornamenti del computer.

  • Se questo valore è $True, Configuration Manager riavvia il computer, se necessario, per completare l'aggiornamento.
  • Se questo valore è $False, Configuration Manager non riavvia il computer.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowSoftwareInstallationOutsideMaintenanceWindow

Indica se la distribuzione dell'aggiornamento viene eseguita anche se pianificata all'esterno di una finestra di manutenzione. Una finestra di manutenzione è un periodo di tempo specificato usato per la manutenzione e gli aggiornamenti del computer.

  • Se questo valore è $True, Configuration Manager distribuisce l'aggiornamento anche se l'ora pianificata non rientra nella finestra del servizio.
  • Se questo valore è $False, Configuration Manager non distribuisce l'aggiornamento all'esterno della finestra del servizio. Attende fino a quando non può essere distribuito in una finestra del servizio.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowUseMeteredNetwork

Indica se consentire ai client di scaricare il contenuto tramite una connessione Internet a consumo dopo la scadenza, il che può comportare costi aggiuntivi.

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

-Architecture

Utilizzare questo parametro per impostare il filtro delle proprietà Architecture nella pagina Aggiornamenti software delle proprietà di ADR.

Tipo:ArchitectureType[]
Alias:Architectures
Valori accettati:Arm64, Itanium, X64, X86
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ArticleId

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software con ID articolo che soddisfano i criteri specificati.

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

-AvailableImmediately

Indica se questa regola distribuisce gli aggiornamenti non appena gli aggiornamenti diventano disponibili. Se si seleziona un valore di $False, usare i parametri -AvailableTime e -AvailableTimeUnit per specificare quanto tempo dopo l'esecuzione della regola per distribuire gli aggiornamenti.

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

-AvailableTime

Specifica un periodo di tempo come intero. Configuration Manager distribuisce gli aggiornamenti molto tempo dopo l'esecuzione della regola. Specificare un'unità di tempo usando il parametro -AvailableTimeUnit .

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

-AvailableTimeUnit

Specifica un'unità di tempo per il parametro -AvailableTime .

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

-BulletinId

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software con ID bollettino che soddisfano i criteri specificati.

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

-CMTag

Questa proprietà è riservata per un uso futuro.

Tipo:CMTagTypes[]
Valori accettati:None, UUP
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Collection

Specificare un oggetto raccolta come destinazione per la regola di distribuzione automatica.

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

-CollectionId

Specificare un ID raccolta come destinazione per la regola di distribuzione automatica.

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

-CollectionName

Specificare un nome di raccolta come destinazione per la regola di distribuzione automatica.

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

-ContentSize

Utilizzare questo parametro per impostare il filtro delle proprietà Dimensioni contenuto (KB) nella pagina Aggiornamenti software delle proprietà ADR.

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

-CustomSeverity

Specifica una matrice di tipi di gravità personalizzati per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software con livelli di gravità personalizzati che soddisfano i criteri specificati.

Tipo:SeverityType[]
Valori accettati:None, Low, Moderate, Important, Critical
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DateReleasedOrRevised

Specifica una data di rilascio o revisione per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software con una data che soddisfa i criteri specificati.

Tipo:DateReleasedOrRevisedType
Valori accettati:Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeadlineImmediately

Indica se imporre la scadenza non appena viene eseguita la regola. Se si specifica un valore di $False, utilizzare i parametri -DeadlineTime e -DeadlineTimeUnit per specificare quanto tempo dopo l'esecuzione della regola per impostare la scadenza. Dopo la scadenza, Configuration Manager installa gli aggiornamenti necessari.

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

-DeadlineTime

Specifica un periodo di tempo come intero. La scadenza per gli aggiornamenti è questa molto tempo dopo l'esecuzione della regola. Specificare un'unità di tempo usando il parametro -DeadlineTimeUnit .

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

-DeadlineTimeUnit

Specifica un'unità di tempo per il parametro -DeadlineTime .

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

-DeploymentPackage

Utilizzare questo parametro per specificare un oggetto per il pacchetto di distribuzione da usare con questa regola di distribuzione automatica. Per non richiedere un pacchetto, impostare il valore su $null.

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

-DeploymentPackageName

Specificare il nome del pacchetto di distribuzione da usare con questa regola di distribuzione automatica. Per non richiedere un pacchetto, impostare il valore su $null.

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

-DeploymentRing

Tipo:DeploymentRing
Valori accettati:CB, Release, BusinessMainstream, Cbb, Ltsb
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeployWithoutLicense

Indica se la regola distribuisce gli aggiornamenti senza licenze.

  • Se si specifica un valore di $True, Configuration Manager distribuisce tutti gli aggiornamenti per questa regola e approva eventuali contratti di licenza.
  • Se questo valore è $False, Configuration Manager distribuisce solo gli aggiornamenti che non includono una licenza o per cui il contratto di licenza è stato approvato.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per la regola di distribuzione automatica per gli aggiornamenti software.

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

-DisableOperationManager

Indica se disabilitare gli avvisi di System Center Operations Manager durante gli 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

-DownloadFromInternet

Indica se i computer scaricano gli aggiornamenti software da Internet. Se si specifica un valore di $False, specificare un percorso alternativo in cui i computer possono scaricare gli aggiornamenti usando il parametro -Location .

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

-DownloadFromMicrosoftUpdate

Indica se i computer scaricano contenuto da Microsoft Update se tale contenuto non è disponibile in un punto di distribuzione preferito del punto di distribuzione remoto.

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

-Enable

Specificare se la regola di distribuzione automatica è abilitata dopo la creazione.

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

-EnabledAfterCreate

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

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

-GenerateFailureAlert

Se la regola non riesce, creare un avviso di Configuration Manager.

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

-GenerateOperationManagerAlert

Indica se generare avvisi di Operations Manager durante un aggiornamento software.

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

-GenerateSuccessAlert

Indica se generare un avviso per la distribuzione corretta.

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

-IsServicingPlan

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

-Language

Specificare una matrice di stringhe di criteri di lingua per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software con lingue che soddisfano i criteri specificati.

Usare il formato della lingua come visualizzato nella console. Ad esempio:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Il formato per la matrice di stringhe è: "English","Hungarian","Chinese (Simplified, PRC)"

Consiglio

Se si esegue questo cmdlet in un computer in cui Windows ha un'interfaccia utente localizzata, i nomi delle lingue potrebbero essere diversi. Ad esempio, la versione inglese di Windows usa "Danese", ma la versione danese di Windows usa "Dansk".

Tipo:String[]
Alias:Languages, UpdateLocales, UpdateLocale
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LanguageSelection

Specificare una matrice di stringhe di lingue. I client scaricano gli aggiornamenti software disponibili nelle lingue specificate e gli aggiornamenti indipendenti dalla lingua.

Usare il formato della lingua come visualizzato nella console. Ad esempio:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Il formato per la matrice di stringhe è: "English","Hungarian","Chinese (Simplified, PRC)"

Consiglio

Se si esegue questo cmdlet in un computer in cui Windows ha un'interfaccia utente localizzata, i nomi delle lingue potrebbero essere diversi. Ad esempio, la versione inglese di Windows usa "Danese", ma la versione danese di Windows usa "Dansk".

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

-Location

Specifica un percorso nella rete in cui i computer possono scaricare gli aggiornamenti software. Per utilizzare questo percorso, specificare il valore di $False per il parametro -DownloadFromInternet .

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

-MicrosoftAsVendor

Indica se la regola include solo gli aggiornamenti con Microsoft come fornitore.

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

-Name

Specifica un nome per la regola di distribuzione automatica per gli aggiornamenti software.

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

-NoInstallOnRemote

Indica se non consentire l'installazione degli aggiornamenti nei sistemi remoti.

  • Se si specifica un valore di $True, se il client si trova all'interno di un limite di rete lento o inaffidabile o quando il client usa un percorso di origine di fallback per il contenuto, Configuration Manager non installa gli aggiornamenti software.
  • Se si specifica un valore di $False, l'installazione procede.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoInstallOnUnprotected

Indica se non consentire l'installazione di aggiornamenti in sistemi non protetti.

  • Se si specifica un valore di $True, se gli aggiornamenti software non sono disponibili in alcun punto di distribuzione preferito, Configuration Manager non scarica e installa gli aggiornamenti software.
  • Se si specifica un valore di $False, l'installazione procede.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-O365LanguageSelection

Usare questo parametro per impostare la selezione della lingua dell'aggiornamento client di Office 365 . Specificare una matrice di stringhe di lingue. I client scaricano gli aggiornamenti software disponibili nelle lingue specificate e gli aggiornamenti indipendenti dalla lingua.

Usare il formato della lingua visualizzato nella console per la selezione della lingua di Windows Update . Questo formato è lo stesso di con il parametro LanguageSelection . Ad esempio:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Il formato per la matrice di stringhe è: "English","Hungarian","Chinese (Simplified, PRC)"

Consiglio

Se si esegue questo cmdlet in un computer in cui Windows ha un'interfaccia utente localizzata, i nomi delle lingue potrebbero essere diversi. Ad esempio, la versione inglese di Windows usa "Danese", ma la versione danese di Windows usa "Dansk".

Attualmente non è possibile specificare con questo parametro tutte le lingue disponibili nella console di Configuration Manager. Ad esempio, non è possibile specificare "Irlandese (Irlanda)" o "Malta (Malta)".

A partire dalla versione 2103, è necessario specificare una lingua con un nome di paese/area geografica. Questa modifica allinea questo parametro con le opzioni nella console di Configuration Manager. Ad esempio, -O365LanguageSelection "English (United States)"

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

-Product

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge gli aggiornamenti software per i prodotti che soddisfano i criteri specificati al gruppo di aggiornamenti software.

A partire dalla versione 2107, quando sono presenti più prodotti con lo stesso nome, vengono selezionati tutti.

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

-Required

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software identificati da obbligatori che soddisfano i criteri specificati.

Tipo:String[]
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

-RunType

Specificare la pianificazione ricorrente per quando il sito valuta l'ADR.

Se si specifica RunTheRuleOnSchedule, specificare una pianificazione usando il parametro -Schedule .

Tipo:RunType
Valori accettati:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Schedule

Specifica un oggetto di pianificazione per la distribuzione. Per ottenere un oggetto pianificazione, usare il cmdlet New-CMSchedule . Specificare una pianificazione per questo parametro se si specifica un valore di RunTheRuleOnSchedule per il parametro -RunType .

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

-SendWakeupPacket

Indica se inviare un pacchetto di riattivazione ai computer prima dell'inizio della distribuzione.

  • Se questo valore è $True, Configuration Manager riattiva un computer dalla sospensione.
  • Se questo valore è $False, non riattiva i computer dalla sospensione.

Per consentire la riattivazione dei computer, è prima necessario configurare la lan di riattivazione.

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

-Severity

Specifica una matrice di livelli di gravità per gli aggiornamenti software. La regola aggiunge gli aggiornamenti software per i tipi di gravità specificati al gruppo di aggiornamenti software.

Tipo:SeverityType[]
Alias:Severities
Valori accettati:None, Low, Moderate, Important, Critical
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 una percentuale per la conformità del client come numero intero compreso tra 0 e 99. Se la conformità scende al di sotto di questa percentuale, Configuration Manager genera avvisi facoltativi.

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

-Superseded

Indica se la regola aggiunge aggiornamenti sostituiti da altri aggiornamenti.

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

-SuppressRestartServer

Indica se eliminare un aggiornamento necessario per un server. Alcuni aggiornamenti software richiedono 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 eliminare un aggiornamento necessario per una workstation. Alcuni aggiornamenti software richiedono 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

-Title

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti software con titoli che soddisfano i criteri specificati.

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

-UpdateClassification

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti con classificazioni di aggiornamento che soddisfano i criteri specificati.

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

-UpdateDeploymentWaitDay

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

-UpdateDescription

Specifica una matrice di criteri, come stringhe, per gli aggiornamenti software. La regola aggiunge al gruppo di aggiornamenti software gli aggiornamenti con descrizioni degli aggiornamenti che soddisfano i criteri specificati.

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

-UseBranchCache

Indica se usare Windows BranchCache per questa distribuzione di aggiornamento. Se si specifica un valore di $True, i client condividono il contenuto 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 tipo di notifica utente.

  • DisplayAll: visualizza in Software Center e mostra tutte le notifiche.
  • DisplaySoftwareCenterOnly: viene visualizzato in Software Center e vengono visualizzate solo le notifiche dei 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

-UseUtc

Indica se usare l'ora UTC (Coordinated Universal Time).

  • Se questo valore è $True, Configuration Manager usa l'ora UTC per questa distribuzione.
  • Se questo valore è $False, Configuration Manager usa l'ora locale.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Vendor

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

-VerboseLevel

Specifica il livello di dettaglio che i client devono segnalare 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 abilitare i filtri di scrittura per i dispositivi incorporati.

  • Per un valore di $True, il dispositivo esegue il commit delle modifiche durante una finestra di manutenzione. Questa azione richiede un riavvio.
  • Per un valore di $False, il dispositivo salva le modifiche in una sovrimpressione e le esegue 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

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_AutoDeployment classe WMI del server.