Delen via


New-CMMaintenanceWindow

SYNOPSIS

Maak een onderhoudsvenster voor een verzameling.

SYNTAX

ByValue (standaard)

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

Gebruik deze cmdlet om een onderhoudsvenster voor een verzameling te maken. Onderhoudsvensters zijn terugkerende perioden waarin de Configuration Manager-client taken kan uitvoeren. U kunt bijvoorbeeld software-updates toepassen of software installeren. Dit venster zorgt ervoor dat belangrijke systeemwijzigingen alleen plaatsvinden op momenten die geen invloed hebben op de productiviteit en uptime.

Zie Onderhoudsvensters gebruiken in Configuration Manager voor meer informatie over onderhoudsvensters.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: een onderhoudsvenster maken

De eerste opdracht maakt gebruik van de cmdlet New-CMSchedule om een planningsobject te maken en slaat het vervolgens op in de $MWSchedule variabele .

Met de tweede opdracht maakt u een onderhoudsvenster met de naam MonthlySchedule voor de opgegeven verzameling. Het onderhoudsvenster maakt gebruik van de planning die is opgeslagen in de $MWSchedule variabele .

$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

Voorbeeld 2: Een onderhoudsvenster kopiëren tussen verzamelingen

Met de eerste opdracht wordt een onderhoudsvenster uit de verzameling met id XYZ0003F ophaald. Vervolgens wordt er een onderhoudsvenster voor de verzameling gemaakt met id XYZ0005D met dezelfde naam, hetzelfde schema en alleen voor software-updates.

$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

-ApplyTo

Geef het type onderhoudsvenster op dat u wilt maken:

  • Any: Het onderhoudsvenster is van toepassing op alle implementaties.
  • SoftwareUpdatesOnly: Het onderhoudsvenster is alleen van toepassing op software-update-implementaties.
  • TaskSequencesOnly: Het onderhoudsvenster is alleen van toepassing op takenreeksimplementaties.

Als u deze parameter niet opgeeft, Any is de standaardwaarde.

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

Deze parameter is afgeschaft. Gebruik de parameter ApplyTo met de waarde SoftwareUpdatesOnly.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ApplyToTaskSequenceOnly

Deze parameter is afgeschaft. Gebruik de parameter ApplyTo met de waarde TaskSequencesOnly.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-CollectionId

Geef de id van een verzameling op om het onderhoudsvenster toe te voegen. Deze id is een standaardverzamelings-id, bijvoorbeeld XYZ0003F .

Type: String
Parameter Sets: ByCollectionId
Aliases:

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

-CollectionName

Geef de naam van een verzameling op om het onderhoudsvenster toe te voegen.

Type: String
Parameter Sets: ByCollectionName
Aliases:

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

-Confirm

Voeg deze parameter toe om te vragen om bevestiging voordat u de cmdlet gaat uitvoeren.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Geef een object op voor een verzameling om het onderhoudsvenster toe te voegen. Gebruik de cmdlet Get-CMCollection om dit object op te halen.

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

Als u een onderhoudsvenster voor een verzameling wilt maken, maar deze niet actief wilt hebben, stelt u deze parameter in op $false . Als u deze parameter niet opgeeft, schakelt deze cmdlet het onderhoudsvenster in.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-IsUtc

Als u het onderhoudsvensterschema wilt configureren voor het gebruik Coordinated Universal Time (UTC), stelt u deze parameter in op $true . Als u deze parameter niet opgeeft, gebruikt het schema lokale tijd.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Geef de naam van het onderhoudsvenster op.

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

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

-Schedule

Geef een planningsobject op voor wanneer het onderhoudsvenster plaatsvindt. Gebruik de cmdlet New-CMSchedule om dit object op te halen.

Het onderhoudsvensterobject slaat de planning op als een tokenreeks. Als u een schema van een ander object wilt kopiëren, gebruikt u de cmdlet Convert-CMSchedule. Bijvoorbeeld 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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ServiceWindow

OPMERKINGEN

Zie WMI-klasse SMS_ServiceWindow server voor meer informatie over dit retourobject en deeigenschappen ervan.

Get-CMMaintenanceWindow

Remove-CMMaintenanceWindow

Set-CMMaintenanceWindow

Convert-CMSchedule New-CMSchedule

Onderhoudsvensters gebruiken in Configuration Manager