Condividi tramite

Get-CMMaintenanceWindow

  • Riferimento
Modulo:
ConfigurationManager

Ottenere le finestre di manutenzione per una raccolta.

Sintassi

Get-CMMaintenanceWindow
   [-InputObject] <IResultObject>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMMaintenanceWindow
   [-CollectionId] <String>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMMaintenanceWindow
   [-CollectionName] <String>
   [-MaintenanceWindowName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per ottenere le finestre di manutenzione per la raccolta specificata. È anche possibile filtrare i risultati in una finestra di manutenzione specifica.

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: Ottenere finestre di manutenzione abilitate per una raccolta in base all'ID

Questo comando ottiene le finestre di manutenzione abilitate per la raccolta specificata.

Get-CMMaintenanceWindow -CollectionID "XYZ0004D" | Where-Object { $_.IsEnabled }

Esempio 2: Ottenere tutte le finestre di manutenzione per un oggetto raccolta

In questo esempio viene prima ottenuto un oggetto raccolta e quindi viene passato nella pipeline per ottenere una finestra di manutenzione in base al nome.

$coll = Get-CMCollection -CollectionID 'XYZ0003F'
$coll | Get-CMMaintenanceWindow -MaintenanceWindowName 'nightly SUM window'

Esempio 3: Ottenere la pianificazione per una finestra di manutenzione

Questo esempio ottiene prima di tutto una finestra di manutenzione per una raccolta specifica. Converte quindi la proprietà ServiceWindowSchedules per visualizzare la pianificazione della finestra di manutenzione.

$mw = Get-CMMaintenanceWindow -CollectionID "XYZ000AB"
Convert-CMSchedule -ScheduleString $mw.ServiceWindowSchedules

Parametri

-CollectionId

Specificare un ID raccolta su cui eseguire una query per le finestre 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 un nome di raccolta su cui eseguire una query per le relative finestre di manutenzione.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
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 raccolta su cui eseguire una query per le relative finestre 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

-MaintenanceWindowName

Specificare il nome di una finestra di manutenzione nella raccolta di destinazione. Per impostazione predefinita, Get-CMMaintenanceWindow restituisce tutte le finestre di manutenzione. Utilizzare questo parametro per filtrare i risultati in base al nome della finestra specificato.

È possibile usare caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo
Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

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.