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 .

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlertTimeUnit

Specifica un'unità di tempo per il parametro AlertTime . I valori validi sono:

  • Ore
  • Giorni
  • Settimane
  • Mesi
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailableImmediately

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailableTime

Specificare quando sono disponibili gli aggiornamenti software.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailableTimeUnit

Specifica il tipo di unità di tempo per il tempo disponibile del software. I valori validi sono:

  • Ore
  • Giorni
  • Settimane
  • Mesi
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineImmediately

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineTime

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineTimeUnit

Specifica il tipo di unità di tempo per la scadenza. I valori validi sono:

  • Ore
  • Giorni
  • Settimane
  • Mesi
Type:TimeUnitType
Accepted values:Hours, Days, Weeks, Months
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentPackage

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

Type:IResultObject
Aliases:InputObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:DeploymentRing
Accepted values:CB, Release, BusinessMainstream, Cbb, Ltsb
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifica una descrizione per il piano di manutenzione.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableOperationManager

Indica se disabilitare gli avvisi di System Center Operations Manager durante gli aggiornamenti software.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DownloadFromInternet

Indica se scaricare gli aggiornamenti software da Internet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enable

Indica se il piano di manutenzione è abilitato.

Type:Boolean
Aliases:Enabled, EnableDeployment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GenerateOperationManagerAlert

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GenerateSuccessAlert

Indica se generare un avviso per la distribuzione corretta.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Language

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Required

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunType

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

  • DoNotRunThisRuleAutomatically
  • RunTheRuleAfterAnySoftwareUpdatePointSynchronization
  • RunTheRuleOnSchedule
Type:RunType
Accepted values:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Specifica l'ora di scadenza (dall'ora disponibile per la distribuzione). Per creare una pianificazione, usare il cmdlet New-CMSchedule .

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Title

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpdateDeploymentWaitDay

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

Type:Int32
Aliases:UpdateDeploymentWaitDays
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseBranchCache

Indica se utilizzare una cache di ramo. Se si specifica un valore di $True, i client condividono il contenuto nella stessa subnet.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserNotification

Specifica il comportamento di notifica dell'esperienza visiva utente. I valori validi sono:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUtc

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:VerboseLevelType
Accepted values:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

System.Object