Set-CMMaintenanceWindow

Modulo:

ConfigurationManager

Modificare una finestra di manutenzione.

Sintassi

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -InputObject <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindow <IResultObject>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionId <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindowName <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionId <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindow <IResultObject>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionName <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindowName <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionName <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindow <IResultObject>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -InputObject <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindowName <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per configurare una finestra di manutenzione in una raccolta.

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: Modificare una finestra di manutenzione da applicare solo alle distribuzioni della sequenza di attività

Questo comando modifica la finestra di manutenzione denominata DiskCleanup nella raccolta con ID XYZ0004D. La finestra di manutenzione viene modificata in modo da essere applicata solo alle sequenze di attività.

Set-CMMaintenanceWindow -Name "DiskCleanup" -CollectionID "XYZ0004D" -ApplyTo TaskSequencesOnly

Parametri

-ApplyTo

Specificare il tipo di finestra di manutenzione:

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

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 configurare una finestra di manutenzione. Questo ID è un ID raccolta standard, ad esempio XYZ0003F.

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

-CollectionName

Specificare il nome di una raccolta per configurare una finestra di manutenzione.

Tipo:	String
Posizione:	Named
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 configurare una finestra di manutenzione. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .

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

-IsEnabled

Usare questo parametro per configurare se la finestra di manutenzione è attiva per la raccolta:

• $true: abilitare la finestra di manutenzione. Le distribuzioni vengono eseguite solo durante la pianificazione della finestra.
• $false: disabilitare la finestra di manutenzione. Le distribuzioni vengono eseguite in qualsiasi momento come configurato.

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.

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

-MaintenanceWindow

Specificare un oggetto finestra di manutenzione da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMMaintenanceWindow .

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

-MaintenanceWindowName

Specificare il nome della finestra di manutenzione da configurare.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Collegamenti correlati

• Get-CMMaintenanceWindow
• New-CMMaintenanceWindow
• Remove-CMMaintenanceWindow
• Convert-CMSchedule
• New-CMSchedule
• Come usare le finestre di manutenzione in Configuration Manager