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.