Compartir a través de

Get-CMMaintenanceWindow

  • Referencia
Módulo:
ConfigurationManager

Obtenga las ventanas de mantenimiento de una colección.

Sintaxis

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

Use este cmdlet para obtener las ventanas de mantenimiento de la colección especificada. También puede filtrar los resultados a una ventana de mantenimiento específica.

Para obtener más información sobre las ventanas de mantenimiento, consulte Uso de ventanas de mantenimiento en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtención de ventanas de mantenimiento habilitadas para una colección por identificador

Este comando obtiene las ventanas de mantenimiento habilitadas para la colección especificada.

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

Ejemplo 2: Obtención de todas las ventanas de mantenimiento de un objeto de colección

En este ejemplo se obtiene primero un objeto de colección y, a continuación, se pasa en la canalización para obtener una ventana de mantenimiento por su nombre.

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

Ejemplo 3: Obtener la programación de una ventana de mantenimiento

En este ejemplo se obtiene primero una ventana de mantenimiento para una colección específica. A continuación, convierte la propiedad ServiceWindowSchedules para mostrar la programación de la ventana de mantenimiento.

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

Parámetros

-CollectionId

Especifique un identificador de colección para consultar sus ventanas de mantenimiento. Este identificador es un identificador de colección estándar, por ejemplo XYZ0003F.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CollectionName

Especifique un nombre de colección para consultar sus ventanas de mantenimiento.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifique un objeto de colección para consultar sus ventanas de mantenimiento. Para obtener este objeto, use el cmdlet Get-CMCollection .

Tipo:IResultObject
Alias:Collection, Site
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-MaintenanceWindowName

Especifique el nombre de una ventana de mantenimiento en la colección de destino. De forma predeterminada, Get-CMMaintenanceWindow devuelve todas las ventanas de mantenimiento. Use este parámetro para filtrar los resultados por el nombre de ventana especificado.

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único
Tipo:String
Alias:Name
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject[]

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_ServiceWindow clase WMI de servidor.