Get-CMMaintenanceWindow

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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

Utilize este cmdlet para obter as janelas de manutenção da coleção especificada. 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 utilizar janelas de manutenção no Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Obter janelas de manutenção ativadas para uma coleção por ID

Este comando obtém as janelas de manutenção que estão ativadas para a coleção especificada.

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

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

Este exemplo obtém primeiro um objeto de coleção e, em seguida, transmite-o no pipeline para obter uma janela de manutenção pelo respetivo 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 obtém primeiro uma janela de manutenção para uma coleção específica. Em seguida, converte a propriedade ServiceWindowSchedules para apresentar a agenda da janela de manutenção.

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

Parâmetros

-CollectionId

Especifique um ID de coleção para consultar as janelas de manutenção. Este ID é um ID de coleção padrão, por exemplo XYZ0003F.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de coleção para consultar as janelas de manutenção. Para obter este objeto, utilize o cmdlet Get-CMCollection .

Tipo:IResultObject
Aliases:Collection, Site
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaintenanceWindowName

Especifique o nome de uma janela de manutenção na coleção de destino. Por predefinição, Get-CMMaintenanceWindow devolve todas as janelas de manutenção. Utilize este parâmetro para filtrar os resultados para o nome da janela especificado.

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único
Tipo:String
Aliases:Name
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_ServiceWindow classe WMI de servidor.