New-CMMaintenanceWindow
Crie uma janela de manutenção para uma coleção.
Syntax
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-InputObject] <IResultObject>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-CollectionId] <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMMaintenanceWindow
[-ApplyTo <MaintenanceWindowApplyTo>]
[-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly]
[-CollectionName] <String>
[-IsEnabled <Boolean>]
[-IsUtc <Boolean>]
-Name <String>
-Schedule <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para criar uma janela de manutenção para uma coleção. Janelas de manutenção são períodos recorrentes de tempo em que o cliente Configuration Manager pode executar tarefas. Por exemplo, aplique atualizações de software ou instale software. Essa janela garante que alterações significativas no sistema só ocorram em momentos que não afetam a produtividade e o tempo de atividade.
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: criar uma janela de manutenção
O primeiro comando usa o cmdlet New-CMSchedule para criar um objeto de agendamento e, em seguida, armazena-o na $MWSchedule
variável.
O segundo comando cria uma janela de manutenção chamada MonthlySchedule para a coleção especificada.
A janela de manutenção usa o agendamento armazenado na $MWSchedule
variável.
$MWSchedule = New-CMSchedule -DayOfWeek Friday -DurationCount 1 -DurationInterval Hours -RecurCount 1 -Start "10/12/2013 21:00:00"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name "MonthlySchedule" -Schedule $MWSchedule
Exemplo 2: copiar uma janela de manutenção entre coleções
O primeiro comando obtém uma janela de manutenção da coleção com ID XYZ0003F. Em seguida, ele cria uma janela de manutenção na coleção com ID XYZ0005D com o mesmo nome, mesmo agendamento e apenas para atualizações de software.
$mw1 = Get-CMMaintenanceWindow -CollectionId "XYZ0003F" -MaintenanceWindowName "nightly SUM window"
New-CMMaintenanceWindow -CollectionId "XYZ0005D" -Name $mw1.Name -Schedule (Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules) -ApplyTo SoftwareUpdatesOnly
Parâmetros
-ApplyTo
Especifique o tipo de janela de manutenção a ser criada:
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.
Se você não especificar esse parâmetro, Any
será o padrão.
Type: | MaintenanceWindowApplyTo |
Accepted values: | Any, SoftwareUpdatesOnly, TaskSequencesOnly |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToSoftwareUpdateOnly
Esse parâmetro foi preterido. Use o parâmetro ApplyTo com o valor SoftwareUpdatesOnly .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplyToTaskSequenceOnly
Esse parâmetro foi preterido. Use o parâmetro ApplyTo com o valor TaskSequencesOnly .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique a ID de uma coleção para adicionar a janela 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 o nome de uma coleção para adicionar a janela de manutenção.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Adicione esse parâmetro para solicitar a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
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 para uma coleção para adicionar a janela 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 |
-IsEnabled
Para criar uma janela de manutenção em uma coleção, mas não tê-la ativa, defina esse parâmetro como $false
. Se você não incluir esse parâmetro, esse cmdlet habilitará a janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUtc
Para configurar o agendamento da janela de manutenção para usar o UTC (Tempo Universal Coordenado), defina esse parâmetro como $true
. Se você não incluir esse parâmetro, a agenda usará a hora local.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique o nome da janela de manutenção.
Type: | String |
Aliases: | MaintenanceWindowName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
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.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de