New-CMMaintenanceWindow

  • Riferimento
Modulo:
ConfigurationManager

Creare una finestra di manutenzione per una raccolta.

Sintassi

New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-InputObject] <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionId] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   [-CollectionName] <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -Name <String>
   -Schedule <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una finestra di manutenzione per una raccolta. Le finestre di manutenzione sono periodi di tempo ricorrenti in cui il client di Configuration Manager può eseguire attività. Ad esempio, applicare gli aggiornamenti software o installare il software. Questa finestra assicura che le modifiche significative del sistema si verifichino solo in momenti che non influiscono sulla produttività e sui tempi di attività.

Per altre informazioni sulle finestre di manutenzione, vedere Come usare le finestre di manutenzione in Configuration Manager.

Nota

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

Esempio

Esempio 1: Creare una finestra di manutenzione

Il primo comando usa il cmdlet New-CMSchedule per creare un oggetto pianificazione e quindi lo archivia nella $MWSchedule variabile .

Il secondo comando crea una finestra di manutenzione denominata MonthlySchedule per la raccolta specificata. La finestra di manutenzione usa la pianificazione archiviata nella $MWSchedule variabile .

$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule

Esempio 2: Copiare una finestra di manutenzione tra raccolte

Il primo comando ottiene una finestra di manutenzione dalla raccolta con ID XYZ0003F. Crea quindi una finestra di manutenzione nella raccolta con ID XYZ0005D con lo stesso nome, la stessa pianificazione e solo per gli aggiornamenti software.

$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly

Parametri

-ApplyTo

Specificare il tipo di finestra di manutenzione da creare:

  • Any: la finestra di manutenzione si applica a tutte le distribuzioni.
  • SoftwareUpdatesOnly: la finestra di manutenzione si applica solo alle distribuzioni di aggiornamenti software.
  • TaskSequencesOnly: la finestra di manutenzione si applica solo alle distribuzioni della sequenza di attività.

Se non si specifica questo parametro, Any è l'impostazione predefinita.

Tipo:MaintenanceWindowApplyTo
Valori accettati:Any, SoftwareUpdatesOnly, TaskSequencesOnly
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplyToSoftwareUpdateOnly

Questo parametro è deprecato. Usare il parametro ApplyTo con il valore SoftwareUpdatesOnly .

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

-ApplyToTaskSequenceOnly

Questo parametro è deprecato. Usare il parametro ApplyTo con il valore TaskSequencesOnly .

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

-CollectionId

Specificare l'ID di una raccolta per aggiungere la finestra di manutenzione. Questo ID è un ID raccolta standard, ad esempio XYZ0003F.

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

-CollectionName

Specificare il nome di una raccolta per aggiungere la finestra di manutenzione.

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

-Confirm

Aggiungere questo parametro per richiedere 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

-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

-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

-InputObject

Specificare un oggetto per una raccolta per aggiungere la finestra di manutenzione. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .

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

-IsEnabled

Per creare una finestra di manutenzione in una raccolta, ma non attiva, impostare questo parametro $falsesu . Se non si include questo parametro, questo cmdlet abilita la finestra di manutenzione.

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

-IsUtc

Per configurare la pianificazione della finestra di manutenzione per l'uso dell'ora UTC (Coordinated Universal Time), impostare questo parametro su $true. Se non si include questo parametro, la pianificazione usa l'ora locale.

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

-Name

Specificare il nome della finestra di manutenzione.

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

-Schedule

Specificare un oggetto pianificazione per quando si verifica la finestra di manutenzione. Per ottenere questo oggetto, usare il cmdlet New-CMSchedule .

L'oggetto finestra di manutenzione archivia la pianificazione come stringa di token. Per copiare una pianificazione da un altro oggetto, usare il cmdlet Convert-CMSchedule . Ad esempio, Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Note

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