New-CMMaintenanceWindow
SYNOPSIS
Skapa en underhållsfönstret för en samling.
SYNTAX
ByValue (standard)
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
Använd den här cmdleten för att skapa en underhållsfönstret för en samling. Underhållsperioder är återkommande tidsperioder när Konfigurationshanteraren kan köra uppgifter. Du kan till exempel tillämpa programuppdateringar eller installera programvara. Det här fönstret ser till att betydande systemändringar bara sker vid tillfällen som inte påverkar produktivitet och drifttid.
Mer information om underhållsfönster finns i Använda underhållsfönster i Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa en underhållsfönstret
Det första kommandot använder cmdleten New-CMSchedule för att skapa ett schemaobjekt och lagrar det sedan i $MWSchedule
variabeln .
Det andra kommandot skapar en underhållstid med namnet MonthlySchedule för den angivna samlingen.
Underhållsfönstret använder det schema som lagras i $MWSchedule
variabeln .
$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
Exempel 2: Kopiera en underhållsfönstret mellan samlingar
Det första kommandot hämtar en underhållsfönstret från samlingen med ID XYZ0003F. Sedan skapas en underhållsfönstret i samlingen med ID XYZ0005D med samma namn, samma schema och endast för programuppdateringar.
$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
Ange typen av underhållsfönstret som ska skapas:
Any
: Underhållsfönstret gäller för alla distributioner.SoftwareUpdatesOnly
: Underhållsfönstret gäller endast programuppdateringsdistributioner.TaskSequencesOnly
: Underhållsfönstret gäller endast för aktivitetssekvensdistributioner.
Om du inte anger den här parametern Any
är standardvärdet.
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 lägga till underhållsfönstret. Detta ID är ett standardinsamlings-ID, till exempel XYZ0003F
.
Type: String
Parameter Sets: ByCollectionId
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange namnet på en samling för att lägga till underhållsfönstret.
Type: String
Parameter Sets: ByCollectionName
Aliases:
Required: True
Position: 0
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 lägga till underhållsfönstret. Hämta det här objektet med hjälp av cmdleten 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
Om du vill skapa en underhållsfönstret för en samling, men inte ha den aktiv, anger du den här parametern till $false
. Om du inte inkluderar den här parametern aktiverar den här cmdleten underhållsfönstret.
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 så att Coordinated Universal Time (UTC) anger du den här parametern till $true
. Om du inte inkluderar den här parametern används lokal tid i schemat.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Ange namnet på underhållsfönstret.
Type: String
Parameter Sets: (All)
Aliases: MaintenanceWindowName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Schema
Ange ett schemaobjekt för när underhållsfönstret ska ske. Använd cmdleten New-CMSchedule för att hämta det här objektet.
Underhållsfönstret 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: True
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
IResultObject#SMS_ServiceWindow
ANTECKNINGAR
Mer information om det här returobjektet och dess egenskaper finns i SMS_ServiceWindow serverns WMI-klass.
RELATED LINKS
Convert-CMSchedule New-CMSchedule
Så här använder du underhållsfönster i Konfigurationshanteraren