Get-CMMaintenanceWindow

  • Referência
Módulo:
ConfigurationManager

Obtenha as janelas de manutenção de uma coleção.

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

Use este cmdlet para obter as janelas de manutenção da coleção especificada. Você também pode filtrar os resultados para uma janela de manutenção específica.

Para obter mais informações sobre janelas de manutenção, consulte Como usar janelas de manutenção no Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: obter janelas de manutenção habilitadas para uma coleção por ID

Esse comando obtém as janelas de manutenção habilitadas para a coleção especificada.

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

Exemplo 2: Obter todas as janelas de manutenção de um objeto de coleção

Este exemplo primeiro obtém um objeto de coleção e, em seguida, passa isso no pipeline para obter uma janela de manutenção pelo nome.

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

Exemplo 3: obter a agenda de uma janela de manutenção

Este exemplo primeiro obtém uma janela de manutenção para uma coleção específica. Em seguida, ele converte a propriedade ServiceWindowSchedules para exibir o agendamento da janela de manutenção.

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

Parâmetros

-CollectionId

Especifique uma ID de coleção para consultar suas janelas de manutenção. Essa ID é uma ID de coleção padrão, por exemplo XYZ0003F.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique um nome de coleção para consultar suas janelas de manutenção.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto de coleção para consultar suas janelas de manutenção. Para obter esse objeto, use o cmdlet Get-CMCollection .

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

-MaintenanceWindowName

Especifique o nome de uma janela de manutenção na coleção de destino. Por padrão, Get-CMMaintenanceWindow retorna todas as janelas de manutenção. Use esse parâmetro para filtrar os resultados para o nome da janela especificado.

Você pode usar caracteres curinga:

  • *: vários caracteres
  • ?: caractere único
Type:String
Aliases:Name
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_ServiceWindow classe WMI do servidor.