Dela via


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.

Get-CMMaintenanceWindow

Remove-CMMaintenanceWindow

Set-CMMaintenanceWindow

Convert-CMSchedule New-CMSchedule

Så här använder du underhållsfönster i Konfigurationshanteraren