Get-CMMaintenanceWindow

Obtenez les fenêtres de maintenance d’une collection.

Syntax

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 cmdlet pour obtenir les fenêtres de maintenance de la collection spécifiée. 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, voir Comment utiliser les fenêtres de maintenance dans Configuration Manager.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

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

Cette commande obtient les fenêtres de maintenance activées pour la collection spécifiée.

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 une collection 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 XYZ0003F exemple.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CollectionName

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

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

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

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

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

Type:IResultObject
Aliases:Collection, Site
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-MaintenanceWindowName

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

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

  • *: Plusieurs caractères
  • ?: Caractère unique
Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

Notes

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