Compartilhar via

Set-CMMaintenanceWindow

  • Referência
Módulo:
ConfigurationManager

Modifique uma janela de manutenção.

Sintaxe

Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -InputObject <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindow <IResultObject>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionId <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindowName <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionId <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindow <IResultObject>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionName <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindowName <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -CollectionName <String>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindow <IResultObject>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMMaintenanceWindow
   [-ApplyTo <MaintenanceWindowApplyTo>]
   [-ApplyToSoftwareUpdateOnly]
   [-ApplyToTaskSequenceOnly]
   -InputObject <IResultObject>
   [-IsEnabled <Boolean>]
   [-IsUtc <Boolean>]
   -MaintenanceWindowName <String>
   [-PassThru]
   [-Schedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar uma janela de manutenção em uma coleção.

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: modificar uma janela de manutenção para aplicar apenas a implantações de sequência de tarefas

Esse comando modifica a janela de manutenção chamada DiskCleanup na coleção com ID XYZ0004D. Ele altera a janela de manutenção para aplicar apenas a sequências de tarefas.

Set-CMMaintenanceWindow -Name "DiskCleanup" -CollectionID "XYZ0004D" -ApplyTo TaskSequencesOnly

Parâmetros

-ApplyTo

Especifique o tipo de janela de manutenção:

  • Any: a janela de manutenção se aplica a todas as implantações.
  • SoftwareUpdatesOnly: a janela de manutenção só se aplica a implantações de atualização de software.
  • TaskSequencesOnly: a janela de manutenção só se aplica a implantações de sequência de tarefas.
Tipo:MaintenanceWindowApplyTo
Valores aceitos:Any, SoftwareUpdatesOnly, TaskSequencesOnly
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplyToSoftwareUpdateOnly

Esse parâmetro foi preterido. Use o parâmetro ApplyTo com o valor SoftwareUpdatesOnly .

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

-ApplyToTaskSequenceOnly

Esse parâmetro foi preterido. Use o parâmetro ApplyTo com o valor TaskSequencesOnly .

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

-CollectionId

Especifique a ID de uma coleção para configurar uma janela de manutenção. Essa ID é uma ID de coleção padrão, por exemplo XYZ0003F.

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

-CollectionName

Especifique o nome de uma coleção para configurar uma janela de manutenção.

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

-Confirm

Adicione esse parâmetro para solicitar a confirmação antes de executar o cmdlet.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 para uma coleção configurar uma janela de manutenção. Para obter esse objeto, use o cmdlet Get-CMCollection .

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

-IsEnabled

Use esse parâmetro para configurar se a janela de manutenção estiver ativa para a coleção:

  • $true: habilite a janela de manutenção. As implantações só são executadas durante a agenda da janela.
  • $false: desabilite a janela de manutenção. As implantações são executadas a qualquer momento, conforme configurado.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IsUtc

Para configurar o agendamento da janela de manutenção para usar o UTC (Tempo Universal Coordenado), defina esse parâmetro como $true.

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

-MaintenanceWindow

Especifique um objeto de janela de manutenção a ser configurado. Para obter esse objeto, use o cmdlet Get-CMMaintenanceWindow .

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

-MaintenanceWindowName

Especifique o nome da janela de manutenção a ser configurada.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-Schedule

Especifique um objeto de agenda para quando a janela de manutenção ocorrer. Para obter esse objeto, use o cmdlet New-CMSchedule .

O objeto da janela de manutenção armazena o agendamento como uma cadeia de caracteres de token. Para copiar um agendamento de outro objeto, use o cmdlet Convert-CMSchedule . Por exemplo, Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object