Condividi tramite

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 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 Configuration Manager cmdlet dall'unità del sito 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.

Type:MaintenanceWindowApplyTo
Accepted values:Any, SoftwareUpdatesOnly, TaskSequencesOnly
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplyToSoftwareUpdateOnly

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

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

-ApplyToTaskSequenceOnly

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

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

-CollectionId

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

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

-CollectionName

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

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

-Confirm

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-InputObject

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

Type:IResultObject
Aliases:Collection, Site
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

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

-Name

Specificare il nome della finestra di manutenzione.

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

Type:IResultObject
Position:Named
Default value:None
Required:True
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

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.