Share via

New-CMMaintenanceWindow

  • Článek

SYNOPSIS

Vytvoření časového období údržby pro kolekci

SYNTAX

ByValue (výchozí)

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

Pomocí této rutiny můžete vytvořit časové období údržby pro kolekci. Časové intervaly pro správu a údržbu jsou periodická časová období, kdy může klient Configuration Manager spouštět úlohy. Můžete například použít aktualizace softwaru nebo instalovat software. V tomto okně se ujistěte, že k významným změnám systému dochází pouze v časech, které neovlivňují produktivitu a dobu provozu.

Další informace o časových obdobích údržby najdete v tématu použití časových období údržby v Configuration Manager.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: vytvoření časového intervalu pro správu a údržbu

První příkaz používá rutinu New-CMSchedule k vytvoření objektu plánu a pak ho uloží do $MWSchedule proměnné.

Druhý příkaz vytvoří okno údržby s názvem MonthlySchedule pro zadanou kolekci. Časové období údržby používá plán uložený v $MWSchedule proměnné.

$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

Příklad 2: kopírování časového období údržby mezi kolekcemi

První příkaz načte časový interval pro správu a údržbu z kolekce s ID XYZ0003F. Potom vytvoří okno údržby pro kolekci s ID XYZ0005D se stejným názvem, stejným plánem a jenom pro aktualizace softwaru.

$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

Zadejte typ časového intervalu údržby, který se má vytvořit:

  • Any: Časové období údržby se vztahuje na všechna nasazení.
  • SoftwareUpdatesOnly: Časové období údržby se vztahuje pouze na nasazení aktualizací softwaru.
  • TaskSequencesOnly: Časové období údržby se vztahuje pouze na nasazení pořadí úkolů.

Pokud tento parametr nezadáte, Any je výchozí hodnota.

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

Tento parametr je zastaralý. Použijte parametr ApplyTo s hodnotou SoftwareUpdatesOnly .

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ApplyToTaskSequenceOnly

Tento parametr je zastaralý. Použijte parametr ApplyTo s hodnotou TaskSequencesOnly .

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-CollectionId

Zadejte ID kolekce, do které chcete přidat časový interval pro správu a údržbu. Toto ID je standardní ID kolekce, například XYZ0003F .

Type: String
Parameter Sets: ByCollectionId
Aliases:

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

-CollectionName

Zadejte název kolekce, do které chcete přidat časový interval pro správu a údržbu.

Type: String
Parameter Sets: ByCollectionName
Aliases:

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

-Confirm

Přidejte tento parametr, který před spuštěním rutiny zobrazí výzvu k potvrzení.

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

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

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

– Položky InputObject

Zadejte objekt pro kolekci, do kterého chcete přidat časový interval pro správu a údržbu. K získání tohoto objektu použijte rutinu 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

-Povoleno

Chcete-li vytvořit časové období údržby pro kolekci, ale není aktivní, nastavte tento parametr na $false . Pokud tento parametr nezadáte, tato rutina povolí okno údržby.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-IsUtc

Chcete-li nakonfigurovat časový interval údržby pro použití koordinovaného univerzálního času (UTC), nastavte tento parametr na $true . Pokud tento parametr nezadáte, použije plán místní čas.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Zadejte název časového intervalu pro správu a údržbu.

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

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

– Plán

Určete objekt plánování, když dojde k časovému období údržby. Chcete-li získat tento objekt, použijte rutinu New-CMSchedule .

Objekt časového období údržby ukládá plán jako řetězec tokenu. Pokud chcete kopírovat plán z jiného objektu, použijte rutinu Convert-CMSchedule . Například, 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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

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

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

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement. ManagementProvider. IResultObject

OUTPUTS

IResultObject # SMS_ServiceWindow

POZNÁMKY

Další informace o tomto návratovém objektu a jeho vlastnostech naleznete v tématu SMS_ServiceWindow serverové třídy služby WMI.

Get-CMMaintenanceWindow

Remove-CMMaintenanceWindow

Set-CMMaintenanceWindow

Convert – CMSchedule New-CMSchedule

Použití časových období údržby v systému Configuration Manager