New-SCOMMaintenanceSchedule

Reference

Modul:: OperationsManager

Vytvoří plán údržby.

Syntax

New-SCOMMaintenanceSchedule
   [-Name] <String>
   [-Recursive]
   [-Enabled]
   [-MonitoringObjects] <Guid[]>
   [-ActiveStartTime] <DateTime>
   [[-ActiveEndDate] <DateTime>]
   [-Duration] <Int32>
   [-ReasonCode] <MaintenanceModeReason>
   [[-Comments] <String>]
   [-FreqType] <Int32>
   [[-FreqInterval] <Int32>]
   [[-FreqRecurrenceFactor] <Int32>]
   [[-FreqRelativeInterval] <Int32>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina New-SCOMMaintenanceSchedule vytvoří plán údržby.

Když je prostředek v režimu údržby, Operations Manager potlačí upozornění, oznámení, pravidla, monitorování, automatické odpovědi, změny stavu a nová upozornění. Plán údržby lze použít k naplánování sady prostředků, která přejde do režimu údržby.

Pomocí této rutiny můžete vytvořit plány, které se spouštějí jednou, denně, týdně nebo měsíčně v konkrétní den nebo den v týdnu. Tato rutina vrátí identifikátor GUID vytvořeného plánu.

Ve výchozím nastavení tato rutina používá aktivní trvalé připojení ke skupině pro správu. Pomocí parametru SCSession určete jiné trvalé připojení. Dočasné připojení ke skupině pro správu můžete vytvořit pomocí parametrů ComputerName a Credential . Další informace zobrazíte zadáním Get-Help about_OpsMgr_Connections.

Příklady

Příklad 1: Přidání objektu počítače s Windows do nového plánu údržby

PS C:\>$windowsComputer = Get-SCOMClass -DisplayName "Windows Computer" | Get-SCOMClassInstance | Where-Object { $_.DisplayName -eq 'Agent01.contoso.local' }
PS C:\>New-SCOMMaintenanceSchedule -Name 'Test Maintenance Schedule' -MonitoringObjects $windowsComputer.Id -ActiveStartTime $((Get-Date).AddMinutes(2)) -DurationInMinutes 240 -ReasonCode PlannedOther -FreqType 1 -Enabled

Příklad ukazující, jak přidat objekt počítače s Windows pro konkrétní server: Agent01.contoso.com do nového plánu údržby po dobu 240 minut a běží jenom 1krát.

Příklad 2: Vytvoření denního plánu údržby

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is UTC (Coordinated Universal Time)
PS C:\>$startDate = [DateTime]::SpecifyKind([DateTime]"2024-03-30T01:00:00", [System.DateTimeKind]::Utc)
PS C:\>$durationInMinutes = 90
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Daily Maintenance at 1AM" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 4 -FreqInterval 1 -Enabled

Příklad, který ukazuje, jak nastavit denní plán údržby pro konkrétní server a přidružené objekty monitorování: Agent01.contoso.local od 1:00 a trvá 90 minut.

Příklad 3: Vytvoření týdenního plánu údržby

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-03-29T02:00:00"
PS C:\>$durationInMinutes = 120
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Weekly Wednesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 8 -FreqInterval 8 -FreqRecurrenceFactor 1 -Enabled

Příklad ukazující, jak každou středu nakonfigurovat týdenní plán údržby pro konkrétní server a přidružené objekty monitorování: Agent01.contoso.local, počínaje 2:00 a trvajícím 120 minut.

Příklad 4: Vytvoření měsíčního plánu údržby

PS C:\>$monitoringObjects = Get-SCOMClassInstance -Name 'Agent01.contoso.local'
PS C:\># Timezone is set to local timezone
PS C:\>$startDate = [DateTime]"2024-04-01T03:00:00"
PS C:\>$durationInMinutes = 180
PS C:\>
PS C:\>New-SCOMMaintenanceSchedule -Name "Monthly Second Tuesday Maintenance" -MonitoringObjects $monitoringObjects.Id -ActiveStartTime $startDate -Duration $durationInMinutes -ReasonCode PlannedOther -FreqType 32 -FreqInterval 2 -FreqRelativeInterval 2 -FreqRecurrenceFactor 1 -Enabled

Příklad ukazující, jak vytvořit měsíční plán údržby pro konkrétní server a přidružené objekty monitorování každé druhé úterý v měsíci: Agent01.contoso.local, počínaje 3:00 a trvajícím 180 minut.

Parametry

-ActiveEndDate

Určuje koncové datum a čas ukončení provádění plánu. Pokud tento parametr není zadaný, plán bude stále běžet (nebo dokud nebude odstraněn nebo zakázán).

Pokud například chcete vytvořit plán, který by měl končit 1. května 2016 v 9:00, musíte jako ActiveEndDate zadat "01-05-2016 09:00:00". Můžete předat řetězec určující požadovaný čas v místním čase. Pokud však chcete zadat čas UTC, měli byste zadat objekt DateTime s dateTimeKind nastaveným na UTC.

Type:	DateTime
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ActiveStartTime

Určuje počáteční datum a čas, kdy musí být plán aktivní. Pokud například chcete vytvořit plán, který by měl začít od 1. května 2016 a musí běžet v 9:00, musíte jako ActiveStartTime zadat "01-05-2016 09:00:00". Můžete předat řetězec určující požadovaný čas v místním čase. Pokud ale chcete zadat čas UTC, musíte zadat objekt DateTime s dateTimeKind nastaveným na UTC.

Type:	DateTime
Position:	4
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Comments

Určuje všechny komentáře čitelné pro člověka pro plán údržby.

Type:	String
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Určuje pole názvů počítačů. Rutina naváže dočasná připojení ke skupinám pro správu pro tyto počítače. Můžete použít názvy NetBIOS, IP adresy nebo plně kvalifikované názvy domén (FQDN). Pokud chcete zadat místní počítač, zadejte název počítače, localhost nebo tečku (.).

Služba System Center Data Access musí být v počítači aktivní. Pokud nezadáte počítač, rutina použije počítač pro aktuální připojení ke skupině pro správu.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Určuje objekt PSCredential pro připojení ke skupině pro správu. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credentialpříkazu . Pokud v parametru ComputerName zadáte počítač, použijte účet, který má přístup k danému počítači. Ve výchozím nastavení je to aktuální uživatel.

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

-Duration

Určuje dobu trvání plánu údržby. Doba trvání plánu údržby je doba, po kterou bude plán údržby trvat.

Type:	Int32
Aliases:	DurationInMinutes
Position:	6
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

Určuje, jestli bude plán při vytvoření povolený nebo zakázaný. Pokud nastavíte hodnotu false, plán se vytvoří, ale bude zakázaný.

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqInterval

Určuje, kdy se má úloha spustit. Tento parametr může být jedna z následujících hodnot:

1 (jednou). Interval frekvence se nepoužívá.
4 (denně). Každý interval četnosti dnů.
8 (týdně). Parametr FreqInterval je jeden nebo více z následujících (v kombinaci s logickým operátorem OR):
- 1 – Neděle
- 2 – Pondělí
- 4 – úterý
- 8 – středa
- 16 - Čtvrtek
- 32 - Pátek
- 64 - Sobota
16 (měsíčně). V den intervalu četnosti v měsíci.
- 1 – Neděle
- 2 – Pondělí
- 3 – Úterý
- 4 – Středa
- 5 – Čtvrtek
- 6 – Pátek
- 7 - sobota
32 (měsíční relativní). Parametr FreqInterval je jednou z následujících hodnot:
- 8 - Den
- 9 . Den v týdnu
- 10 - Víkendový den

Type:	Int32
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRecurrenceFactor

Počet týdnů nebo měsíců mezi plánovaným spuštěním úlohy FreqRecurrenceFactor se používá pouze v případě, že je parametr FreqType nastavený na hodnotu 8, 16 nebo 32. Parametr FreqRecurrenceFactor je celé číslo s výchozí hodnotou 0.

Type:	Int32
Position:	11
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqRelativeInterval

Den, kdy je úloha spuštěna. To je povinné, pokud je plán jiný než plán OnceRecurrence . Hodnota závisí na hodnotě FreqType.

Tento parametr může být jedna z následujících hodnot:

1 (První)
2 (sekunda)
4 (třetí)
8 (čtvrtá)
16 (poslední)

Type:	Int32
Position:	12
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FreqType

Určuje, kdy se má úloha spustit. Tento parametr přijímá tyto hodnoty:

1 (jednou)
4 (denně)
8 (týdně)
16 (měsíčně)
32 (měsíčně, vzhledem k parametru FreqInterval)

Type:	Int32
Position:	9
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MonitoringObjects

Určuje pole identifikátorů GUID objektů monitorování, které se převedou do režimu údržby. Chcete-li zadat objekt monitorování, který vytvořený plán převede do režimu údržby, musíte předat atribut ID objektu monitorování.

Pro plán můžete zadat jeden nebo více objektů monitorování. Nelze však vytvořit plán bez objektu monitorování.

Type:	Guid[]
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Určuje název plánu, který tato rutina vytvoří.

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

-ReasonCode

Určuje kód důvodu pro plán údržby, který určuje důvod časového období údržby.

Tento parametr přijímá tyto hodnoty:

PlannedOther
UnplannedOther
PlannedHardwareMaintenance
UnplannedHardwareMaintenance
PlannedHardwareInstallation
UnplannedHardwareInstallation
PlannedOperatingSystemReconfiguration
UnplannedOperatingSystemReconfiguration
PlannedApplicationMaintenance
UnplannedApplicationMaintenance
ApplicationInstallation
ApplicationUnresponsive
ApplicationUnstable
SecurityIssue
LossOfNetworkConnectivity

Type:	MaintenanceModeReason
Accepted values:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	7
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Recursive

Určuje, jestli se plán vztahuje na prostředek nejvyšší úrovně nebo na všechny obsažené prostředky. Pokud je rekurzivní parametr nastaven na hodnotu false, přejde do režimu údržby při spuštění plánu pouze zadaný prostředek. Pokud je nastavená hodnota true, přejdou zadaný prostředek a všechny prostředky, které mají s tímto prostředkem vztah uzavření, také do režimu údržby.

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SCSession

Určuje pole objektů připojení .

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Sdílet prostřednictvím

New-SCOMMaintenanceSchedule

Syntax

Description

Příklady

Příklad 1: Přidání objektu počítače s Windows do nového plánu údržby

Příklad 2: Vytvoření denního plánu údržby

Příklad 3: Vytvoření týdenního plánu údržby

Příklad 4: Vytvoření měsíčního plánu údržby

Parametry

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

Další materiály

Sdílet prostřednictvím

New-SCOMMaintenanceSchedule

Syntax

Description

Příklady

Příklad 1: Přidání objektu počítače s Windows do nového plánu údržby

Příklad 2: Vytvoření denního plánu údržby

Příklad 3: Vytvoření týdenního plánu údržby

Příklad 4: Vytvoření měsíčního plánu údržby

Parametry

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

Související odkazy

Další materiály