Set-CMMaintenanceWindow
SYNOPSIS
Modifique uma janela de manutenção.
SYNTAX
ByValueMWValue (Padrão)
Set-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] -InputObject <IResultObject> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-MaintenanceWindow <IResultObject> [-PassThru] [-Schedule <IResultObject>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
ByCollectionIdMWName
Set-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] -CollectionId <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-MaintenanceWindowName <String> [-PassThru] [-Schedule <IResultObject>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
ByCollectionIdMWValue
Set-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] -CollectionId <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-MaintenanceWindow <IResultObject> [-PassThru] [-Schedule <IResultObject>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
ByCollectionNameMWName
Set-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] -CollectionName <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-MaintenanceWindowName <String> [-PassThru] [-Schedule <IResultObject>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
ByCollectionNamemWValue
Set-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] -CollectionName <String> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-MaintenanceWindow <IResultObject> [-PassThru] [-Schedule <IResultObject>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
ByValueMWName
Set-CMMaintenanceWindow [-ApplyTo <MaintenanceWindowApplyTo>] [-ApplyToSoftwareUpdateOnly]
[-ApplyToTaskSequenceOnly] -InputObject <IResultObject> [-IsEnabled <Boolean>] [-IsUtc <Boolean>]
-MaintenanceWindowName <String> [-PassThru] [-Schedule <IResultObject>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Utilize este cmdlet para configurar uma janela de manutenção numa coleção.
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: Modificar uma janela de manutenção apenas para aplicar às implementações da sequência de tarefas
Este comando modifica a janela de manutenção chamada DiskCleanup na coleção com ID XYZ0004D. Altera a janela de manutenção para se aplicar apenas às sequências de tarefas.
Set-CMMaintenanceWindow -Name "DiskCleanup" -CollectionID "XYZ0004D" -ApplyTo TaskSequencesOnly
PARAMETERS
-AplicarTo
Especificar o tipo de janela de manutenção:
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.
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 a identificação de uma coleção para configurar uma janela de manutenção. Este ID é um ID de coleção padrão, por XYZ0003F
exemplo.
Type: String
Parameter Sets: ByCollectionIdMWName, ByCollectionIdMWValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifique o nome de uma coleção para configurar uma janela de manutenção.
Type: String
Parameter Sets: ByCollectionNameMWName, ByCollectionNameMWValue
Aliases:
Required: True
Position: Named
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 coleção para configurar uma janela de manutenção. Para obter este objeto, utilize o cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: ByValueMWValue, ByValueMWName
Aliases: Collection, Site
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-IsEnabled
Utilize este parâmetro para configurar se a janela de manutenção estiver ativa para a recolha:
$true
: Ativar a janela de manutenção. As colocações só funcionam durante o horário da janela.$false
: Desative a janela de manutenção. As implementações são executadas a qualquer momento, conforme configurado.
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
.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManutençãoWindow
Especifique um objeto de janela de manutenção para configurar. Para obter este objeto, utilize o cmdlet Get-CMMaintenanceWindow.
Type: IResultObject
Parameter Sets: ByValueMWValue, ByCollectionIdMWValue, ByCollectionNameMWValue
Aliases: ScheduleWindow
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-ManutençãoWindowName
Especifique o nome da janela de manutenção para configurar.
Type: String
Parameter Sets: ByCollectionIdMWName, ByCollectionNameMWName, ByValueMWName
Aliases: Name
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Adicione este parâmetro para devolver um objeto que represente o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
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: False
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
Sistema.Objeto
NOTAS
RELATED LINKS
Converte-CMSchedule Novo CMSchedule
Como utilizar janelas de manutenção no Gestor de Configuração