Condividi tramite


New-CMWindowsServicingPlan

Crea un piano di manutenzione Windows 10.

Sintassi

New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionName <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -Collection <IResultObject>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMWindowsServicingPlan
   -Name <String>
   [-Description <String>]
   -CollectionId <String>
   [-Enable <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-VerboseLevel <VerboseLevelType>]
   [-Language <String[]>]
   [-Required <String[]>]
   [-Title <String[]>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-UseUtc <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-UserNotification <UserNotificationType>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowRestart <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-WriteFilterHandling <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-SuccessPercentage <Int32>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-DisableOperationManager <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-UseBranchCache <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-DeploymentPackage <IResultObject>]
   [-DownloadFromInternet <Boolean>]
   [-Location <String>]
   [-DeploymentRing <DeploymentRing>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-LanguageSelection <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-CMWindowsServicingPlan crea un piano di manutenzione Windows 10.

Nota

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

Esempio

Esempio 1: Creare un piano di manutenzione in base all'ID raccolta

PS XYZ:\> $Lang = ("Japanese", "English", "French")
PS XYZ:\> $Required = (">=1", "<=100")
PS XYZ:\> $Title = ("Title1", "Title2", "Title3")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test01" -CollectionId MP40001A -Description "Servicing Plan description01" -SendWakeupPacket $False -VerboseLevel AllMessages -Language $Lang -Required $Required -Title $Title -RunType DoNotRunThisRuleAutomatically -UseUtc $True -AvailableImmediately $True -DeadlineImmediately $False -UserNotification DisplayAll -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowRestart $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUDP01")

Il primo comando crea un elenco di lingue e archivia l'elenco nella variabile $Lang.

Il secondo comando crea un elenco di stringhe di ricerca e archivia l'elenco nella variabile $Required. Questa stringa di ricerca troverà gli aggiornamenti software necessari in almeno un computer e un massimo di 100 computer.

Il terzo comando crea un elenco di titoli di aggiornamento software e archivia l'elenco nella variabile $Title.

L'ultimo comando ottiene il pacchetto di distribuzione dell'aggiornamento software denominato SUDP01 e quindi crea un piano di manutenzione di Windows denominato Test per la raccolta di destinazione con l'ID MP40001A. Il comando aggiunge le lingue del filtro di aggiornamento archiviate in $Lang, il filtro obbligatorio archiviato in $Required e il filtro del titolo dell'aggiornamento software archiviato in $Title.

Esempio 2: Creare un piano di manutenzione in base al nome della raccolta

PS XYZ:\> $LangSelect = ("Japanese", "English", "French", "German")
PS XYZ:\> New-CMWindowsServicingPlan -Name "Test02" -CollectionName "ColName02" -DeploymentPackage (Get-CMSoftwareUpdateDeploymentPackage -Name "SUP02") -WriteFilterHandling $True -GenerateSuccessAlert $True -SuccessPercentage $True -AlertTime 10 -AlertTimeUnit Days -DisableOperationManager $True -GenerateOperationManagerAlert $True -NoInstallOnRemote $True -NoInstallOnUnprotected $True -UseBranchCache $True -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True -DownloadFromInternet $True -Location "\\TestSevr\WSUSTemp" -DeploymentRing Cbb -UpdateDeploymentWaitDay 20 -LanguageSelection $LangSelect

Il primo comando crea un elenco di lingue di selezione della lingua e archivia l'elenco nella variabile $LangSelect.

Il secondo comando ottiene il pacchetto di distribuzione dell'aggiornamento software denominato SUP02 e quindi crea un piano di manutenzione di Windows denominato Test02 per la raccolta di destinazione denominata ColName02. Il comando aggiunge le lingue di selezione della lingua archiviate in $LangSelect.

Parametri

-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 . 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

-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

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

-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

Specificare quando sono disponibili gli aggiornamenti 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 l'oggetto raccolta di dispositivi di destinazione da utilizzare per il piano di manutenzione. Per ottenere un oggetto raccolta di dispositivi, usare i cmdlet Get-CMCollection o Get-CMDeviceCollection .

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

-CollectionId

Specifica l'ID della raccolta di dispositivi di destinazione da usare per il piano di manutenzione.

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

-CollectionName

Specifica il nome della raccolta di dispositivi di destinazione da usare per il piano di manutenzione.

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

-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

-DeploymentPackage

Specifica un pacchetto di distribuzione dell'aggiornamento software. Per ottenere un pacchetto di distribuzione dell'aggiornamento software, usare il cmdlet Get-CMSoftwareUpdateDeploymentPackage .

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

-DeploymentRing

Specifica lo stato di preparazione di Windows a cui deve essere applicato il piano di manutenzione. I valori validi sono:

  • CB
  • Rilascio
  • BusinessMainstream
  • Cbb
  • Ltsb
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

-Description

Specifica una descrizione per il piano di manutenzione.

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

-DownloadFromInternet

Indica se scaricare gli aggiornamenti software da Internet.

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 gli aggiornamenti software non sono disponibili in un punto di distribuzione preferito o in un punto di distribuzione remoto.

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

-Enable

Indica se il piano di manutenzione è abilitato.

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

-Language

Specifica una matrice di lingue usate per filtrare gli aggiornamenti software che verranno aggiunti al piano di servizio.

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

-LanguageSelection

Specifica una matrice di lingue, come stringhe. I computer scaricano gli aggiornamenti software disponibili nelle lingue specificate, oltre agli aggiornamenti non specifici della lingua.

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

-Location

Specifica un percorso di rete in cui si trovano gli aggiornamenti scaricati.

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

-Name

Specifica un nome per il piano di manutenzione. Il nome deve essere univoco, aiutare a descrivere l'obiettivo della regola e identificarlo da altri utenti nel sito Configuration Manager.

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

-NoInstallOnRemote

Indica se 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 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

-Required

Specifica una matrice di stringhe di ricerca usate per filtrare gli aggiornamenti software che verranno aggiunti al piano di servizio.

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

-RunType

Specifica la modalità in cui viene eseguito un aggiornamento. I valori validi sono:

  • DoNotRunThisRuleAutomatically
  • RunTheRuleAfterAnySoftwareUpdatePointSynchronization
  • RunTheRuleOnSchedule
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 l'ora di scadenza (dall'ora disponibile per la distribuzione). Per creare una pianificazione, usare il cmdlet New-CMSchedule .

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

-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

-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

-Title

Specifica una matrice di stringhe di ricerca usate per filtrare i titoli di aggiornamento software che verranno aggiunti al piano di servizio.

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

-UpdateDeploymentWaitDay

Specifica il numero di giorni di attesa dopo che Microsoft ha pubblicato un nuovo aggiornamento prima della distribuzione nell'ambiente.

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

-UseBranchCache

Indica se utilizzare una cache di ramo. 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 comportamento di notifica dell'esperienza visiva utente. I valori validi sono:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
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 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 il livello di dettaglio che i client devono segnalare per le distribuzioni create da questa regola. I valori validi sono:

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

None

Output

System.Object