Partager via

Get-CMMaintenanceWindow

  • Référence
Module:
ConfigurationManager

Obtenez les fenêtres de maintenance d’un regroupement.

Syntaxe

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>]

Description

Utilisez cette applet de commande pour obtenir les fenêtres de maintenance pour le regroupement spécifié. Vous pouvez également filtrer les résultats dans une fenêtre de maintenance spécifique.

Pour plus d’informations sur les fenêtres de maintenance, consultez Comment utiliser les fenêtres de maintenance dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir les fenêtres de maintenance activées pour un regroupement par ID

Cette commande obtient les fenêtres de maintenance activées pour le regroupement spécifié.

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

Exemple 2 : Obtenir toutes les fenêtres de maintenance d’un objet de collection

Cet exemple obtient d’abord un objet de collection, puis le transmet au pipeline pour obtenir une fenêtre de maintenance par son nom.

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

Exemple 3 : Obtenir la planification d’une fenêtre de maintenance

Cet exemple obtient d’abord une fenêtre de maintenance pour un regroupement spécifique. Il convertit ensuite la propriété ServiceWindowSchedules pour afficher la planification de la fenêtre de maintenance.

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

Paramètres

-CollectionId

Spécifiez un ID de collection à interroger pour ses fenêtres de maintenance. Cet ID est un ID de collection standard, par exemple XYZ0003F.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifiez un nom de collection à interroger pour ses fenêtres de maintenance.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet de collection à interroger pour ses fenêtres de maintenance. Pour obtenir cet objet, utilisez l’applet de commande Get-CMCollection .

Type:IResultObject
Alias:Collection, Site
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MaintenanceWindowName

Spécifiez le nom d’une fenêtre de maintenance sur le regroupement ciblé. Par défaut, Get-CMMaintenanceWindow retourne toutes les fenêtres de maintenance. Utilisez ce paramètre pour filtrer les résultats sur le nom de fenêtre spécifié.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
Type:String
Alias:Name
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_ServiceWindow classe WMI du serveur.