Dela via


Set-CMMaintenanceWindow

SYNOPSIS

Ändra en underhållsfönstret.

SYNTAX

ByValueMWValue (standard)

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

Använd den här cmdleten för att konfigurera en underhållsfönstret för en samling.

Mer information om underhållsfönster finns i Så här använder du underhåll windows i Konfigurationshanteraren.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ändra en underhållsfönstret så att den endast gäller för aktivitetssekvensdistributioner

Det här kommandot ändrar underhållsfönstret med namnet DiskCleanup i samlingen med ID XYZ0004D. Underhållsfönstret ändras så att det endast tillämpas på aktivitetssekvenser.

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

PARAMETERS

-ApplyTo

Ange typ av underhållsfönstret:

  • Any: Underhållsfönstret gäller för alla distributioner.
  • SoftwareUpdatesOnly: Underhållsfönstret gäller endast för programuppdateringsdistributioner.
  • TaskSequencesOnly: Underhållsfönstret gäller endast för aktivitetssekvensdistributioner.
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

Den här parametern är inaktuell. Använd parametern ApplyTo med värdet SoftwareUpdatesOnly.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ApplyToTaskSequenceOnly

Den här parametern är inaktuell. Använd parametern ApplyTo med värdet TaskSequencesOnly.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-CollectionId

Ange ID för en samling för att konfigurera en underhållsfönstret. Det här ID:t är ett standardsamlings-ID, till exempel XYZ0003F .

Type: String
Parameter Sets: ByCollectionIdMWName, ByCollectionIdMWValue
Aliases:

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

-CollectionName

Ange namnet på en samling för att konfigurera en underhållsfönstret.

Type: String
Parameter Sets: ByCollectionNameMWName, ByCollectionNameMWValue
Aliases:

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

-Confirm

Lägg till den här parametern för att fråga efter bekräftelse innan du kör cmdleten.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Ange ett objekt för en samling för att konfigurera en underhållsfönstret. Hämta det här objektet med cmdleten 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

Använd den här parametern för att konfigurera om underhållsfönstret är aktivt för samlingen:

  • $true: Aktivera underhållsfönstret. Distributioner körs bara under fönstrets schema.
  • $false: Inaktivera underhållsfönstret. Distributioner körs när som helst enligt konfiguration.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-IsUtc

Om du vill konfigurera underhållsfönstrets schema för användning Coordinated Universal Time (UTC) anger du den här parametern till $true .

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MaintenanceWindow

Ange ett underhållsfönsterobjekt som ska konfigureras. Hämta det här objektet med hjälp av cmdleten 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

-MaintenanceWindowName

Ange namnet på underhållsfönstret som ska konfigureras.

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

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Schema

Ange ett schemaobjekt för när underhållsfönstret inträffar. Hämta det här objektet med hjälp av cmdleten New-CMSchedule.

Underhållsfönstrets objekt lagrar schemat som en tokensträng. Om du vill kopiera ett schema från ett annat objekt använder du cmdleten Convert-CMSchedule. Till exempel 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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Get-CMMaintenanceWindow

New-CMMaintenanceWindow

Remove-CMMaintenanceWindow

Convert-CMSchedule New-CMSchedule

Så här använder du underhåll windows i Konfigurationshanteraren