Get-CMMaintenanceWindow

  • Référence
Module:
ConfigurationManager

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

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 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 Utilisation des fenêtres de maintenance dans Configuration Manager.

Remarque

Exécutez Configuration Manager applets de commande à 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
Default value:None
Required:True
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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
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
Required:False
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 l’applet de commande Get-CMCollection .

Type:IResultObject
Aliases:Collection, Site
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:Name
Position:Named
Default value:None
Required:False
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, consultez SMS_ServiceWindow classe WMI du serveur.