New-CMMaintenanceWindow

SYNOPSIS

Crie uma janela de manutenção para uma coleção.

SYNTAX

ByValue (Padrão)

New-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
 [-ApplyToTaskSequenceOnly] [-InputObject] <IResultObject> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
 -Name <String> -Schedule <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ByCollectionId

New-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
 [-ApplyToTaskSequenceOnly] [-CollectionId] <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>] -Name <String>
 -Schedule <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ByCollectionName

New-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
 [-ApplyToTaskSequenceOnly] [-CollectionName] <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>] -Name <String>
 -Schedule <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Utilize este cmdlet para criar uma janela de manutenção para uma recolha. As janelas de manutenção são períodos de tempo recorrentes quando o cliente Do Gestor de Configuração pode executar tarefas. Por exemplo, aplicar atualizações de software ou instalar software. Esta janela garante que mudanças significativas no sistema só acontecem em momentos que não afetam a produtividade e o tempo de arranque.

Para obter mais informações sobre janelas de manutenção, consulte como utilizar janelas de manutenção no Gestor de Configuração.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Criar uma janela de manutenção

O primeiro comando usa o cmdlet New-CMSchedule para criar um objeto de agenda 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 utiliza o horário 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, cria uma janela de manutenção na coleção com ID XYZ0005D com o mesmo nome, mesmo horário, 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

PARAMETERS

-AplicarTo

Especifique o tipo de janela de manutenção para criar:

• Any: A janela de manutenção aplica-se a todas as colocações.
• SoftwareUpdatesOnly: A janela de manutenção aplica-se apenas às implementações de atualização de software.
• TaskSequencesOnly: A janela de manutenção aplica-se apenas às implementações da sequência de tarefas.

Se não especificar este parâmetro, Any é o padrão.

Type: MaintenanceWindowApplyTo
Parameter Sets: (All)
Aliases:
Accepted values: Any, SoftwareUpdatesOnly, TaskSequencesOnly

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

-ApplyToSoftwareUpdateOnly

Este parâmetro está precotado. Utilize o parâmetro ApplyTo com o valor de SoftwareUpdatesOnly.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ApplyToTaskSequenceOnly

Este parâmetro está precotado. Utilize o parâmetro ApplyTo com o valor TaskSequencesOnly.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-CollectionId

Especifique o ID de uma coleção para adicionar a janela de manutenção. Este ID é um ID de coleção padrão, por XYZ0003F exemplo.

Type: String
Parameter Sets: ByCollectionId
Aliases:

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

-Nome de coleção

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

Type: String
Parameter Sets: ByCollectionName
Aliases:

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Especifique um objeto para uma recolha para adicionar a janela de manutenção. Para obter este objeto, utilize o cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: ByValue
Aliases: Collection, Site

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-IsEnabled

Para criar uma janela de manutenção numa coleção, mas não a tenha ativa, deslote este parâmetro para $false . Se não incluir este parâmetro, este cmdlet permite a janela de manutenção.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Isutc

Para configurar o calendário da janela de manutenção para utilizar o Tempo Universal Coordenado (UTC), deslogeu este parâmetro para $true . Se não incluir este parâmetro, o horário utiliza a hora local.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Especifique o nome da janela de manutenção.

Type: String
Parameter Sets: (All)
Aliases: MaintenanceWindowName

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

-Horário

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

O objeto da janela de manutenção armazena o horário como uma corda simbólica. Para copiar um horário de outro objeto, utilize o cmdlet Convert-CMSchedule. Por exemplo, Convert-CMSchedule -ScheduleString $mw1.ServiceWindowSchedules.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ServiceWindow

NOTAS

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

RELATED LINKS

Get-CMMaintenanceWindow

Remover-CMMaintenanceWindow

Set-CMMaintenanceWindow

Converte-CMSchedule Novo CMSchedule

Como utilizar janelas de manutenção no Gestor de Configuração