New-SCOMMaintenanceSchedule

Odwołanie

Moduł:: OperationsManager

Tworzy harmonogram konserwacji.

Składnia

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>]

Opis

Polecenie cmdlet New-SCOMMaintenanceSchedule tworzy harmonogram konserwacji.

Gdy zasób jest w trybie konserwacji, program Operations Manager pomija alerty, powiadomienia, reguły, monitory, odpowiedzi automatyczne, zmiany stanu i nowe alerty. Harmonogram konserwacji może służyć do planowania zestawu zasobów, aby przejść do trybu konserwacji.

To polecenie cmdlet służy do tworzenia harmonogramów uruchamianych raz, codziennie, co tydzień lub co miesiąc w określonym dniu lub dniu tygodnia. To polecenie cmdlet zwróci identyfikator GUID utworzonego harmonogramu.

Domyślnie to polecenie cmdlet używa aktywnego trwałego połączenia z grupą zarządzania. Użyj parametru SCSession , aby określić inne trwałe połączenie. Możesz utworzyć tymczasowe połączenie z grupą zarządzania przy użyciu parametrów ComputerName i Credential . Aby uzyskać więcej informacji, wpisz polecenie Get-Help about_OpsMgr_Connections.

Przykłady

Przykład 1. Dodawanie obiektu komputera z systemem Windows do nowego harmonogramu konserwacji

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

Przykład pokazujący sposób dodawania obiektu komputera z systemem Windows dla określonego serwera: Agent01.contoso.com do nowego harmonogramu konserwacji, przez czas trwania 240 minut, uruchomiony tylko 1 czas.

Przykład 2. Tworzenie dziennego harmonogramu konserwacji

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

Przykład pokazujący sposób konfigurowania dziennego harmonogramu konserwacji dla określonego serwera i skojarzonych obiektów monitorowania: Agent01.contoso.local, począwszy od godziny 1:00 i trwającej przez 90 minut.

Przykład 3. Tworzenie cotygodniowego harmonogramu konserwacji

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

Przykład pokazujący sposób konfigurowania cotygodniowego harmonogramu konserwacji co środę dla określonego serwera i skojarzonych obiektów monitorowania: Agent01.contoso.local, począwszy od godziny 2:00 i trwającej przez 120 minut.

Przykład 4. Tworzenie miesięcznego harmonogramu konserwacji

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

Przykład pokazujący, jak ustanowić miesięczny harmonogram konserwacji w drugi wtorek każdego miesiąca dla określonego serwera i skojarzonych obiektów monitorowania: Agent01.contoso.local, począwszy od godziny 3:00 i trwającej przez 180 minut.

Parametry

-ActiveEndDate

Określa datę zakończenia i godzinę zakończenia, kiedy harmonogram powinien przestać działać. Jeśli ten parametr nie zostanie określony, harmonogram będzie nadal działać przez cały czas (lub dopóki nie zostanie usunięty lub wyłączony).

Jeśli na przykład chcesz utworzyć harmonogram, który powinien zakończyć się 1 maja 2016 o godzinie 9:00, musisz określić wartość "01-05-2016 09:00:00" jako wartość ActiveEndDate. Możesz przekazać ciąg określający żądany czas w czasie lokalnym. Jeśli jednak chcesz określić godzinę UTC, należy określić obiekt DateTime z wartością DateTimeKind ustawioną na utc.

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

-ActiveStartTime

Określa datę rozpoczęcia i godzinę, kiedy harmonogram musi być aktywny. Jeśli na przykład chcesz utworzyć harmonogram, który powinien zaczynać się od 1 maja 2016 r. i musi działać o godzinie 9:00, musisz określić wartość "01-05-2016 09:00:00" jako wartość ActiveStartTime. Możesz przekazać ciąg określający żądany czas w czasie lokalnym. Jeśli jednak chcesz określić godzinę UTC, musisz określić obiekt DateTime z wartością DateTimeKind ustawioną na utc.

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

-Comments

Określa wszelkie komentarze czytelne dla człowieka dla harmonogramu konserwacji.

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

-ComputerName

Określa tablicę nazw komputerów. Polecenie cmdlet ustanawia tymczasowe połączenia z grupami zarządzania dla tych komputerów. Można użyć nazw NetBIOS, adresów IP lub w pełni kwalifikowanych nazw domen (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.).

Usługa System Center Data Access musi być aktywna na komputerze. Jeśli komputer nie zostanie określony, polecenie cmdlet użyje komputera dla bieżącego połączenia grupy zarządzania.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Określa obiekt PSCredential dla połączenia grupy zarządzania. Aby uzyskać obiekt PSCredential , użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz Get-Help Get-Credential. Jeśli określisz komputer w parametrze ComputerName , użyj konta, które ma dostęp do tego komputera. Wartość domyślna to użytkownik bieżący.

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

-Duration

Określa czas trwania harmonogramu konserwacji. Czas trwania harmonogramu konserwacji to czas, dla którego harmonogram konserwacji będzie trwać.

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

-Enabled

Wskazuje, czy harmonogram zostanie włączony, czy wyłączony podczas tworzenia. Jeśli ustawisz wartość false, harmonogram zostanie utworzony, ale zostanie wyłączony.

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

-FreqInterval

Określa, kiedy zadanie ma zostać wykonane. Ten parametr może być jedną z następujących wartości:

1 (raz). Interwał częstotliwości jest nieużywany.
4 (codziennie). Co interwał częstotliwości dni.
8 (co tydzień). Parametr FreqInterval jest co najmniej jednym z następujących parametrów (w połączeniu z operatorem logicznym OR):
- 1 — niedziela
- 2 — poniedziałek
- 4 — wtorek
- 8 – środa
- 16 — czwartek
- 32 — piątek
- 64 — sobota
16 (co miesiąc). W dniu interwału częstotliwości miesiąca.
- 1 — niedziela
- 2 — poniedziałek
- 3 — wtorek
- 4 — środa
- 5 — czwartek
- 6 — piątek
- 7 — sobota
32 (miesięczny względny). Parametr FreqInterval jest jedną z następujących wartości:
- 8 — dzień
- 9 — Dzień tygodnia
- 10 — dzień weekendowy

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

-FreqRecurrenceFactor

Liczba tygodni lub miesięcy między zaplanowanym wykonaniem zadania. Parametr FreqRecurrenceFactor jest używany tylko wtedy, gdy parametr FreqType ma wartość 8, 16 lub 32. Parametr FreqRecurrenceFactor jest liczbą całkowitą z wartością domyślną 0.

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

-FreqRelativeInterval

Dzień wykonania zadania. Jest to obowiązkowe, jeśli harmonogram jest inny niż harmonogram OnceRecurrence . Wartość zależy od wartości FreqType.

Ten parametr może być jedną z następujących wartości:

1 (Pierwszy)
2 (drugi)
4 (trzeci)
8 (czwarty)
16 (ostatni)

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

-FreqType

Określa, kiedy zadanie ma zostać wykonane. Dopuszczalne wartości dla tego parametru to:

1 (raz)
4 (codziennie)
8 (co tydzień)
16 (miesięcznie)
32 (Co miesiąc w stosunku do parametru FreqInterval)

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

-MonitoringObjects

Określa tablicę identyfikatorów GUID obiektów monitorowania, które zostaną przełączone w tryb konserwacji. Aby określić obiekt monitorowania, który utworzony harmonogram zostanie wprowadzony w tryb konserwacji, należy przekazać atrybut ID obiektu monitorowania.

Można określić co najmniej jeden obiekt monitorowania dla harmonogramu. Nie można jednak utworzyć harmonogramu bez żadnego obiektu monitorowania.

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

-Name

Określa nazwę harmonogramu tworzonego przez to polecenie cmdlet.

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

-ReasonCode

Określa kod przyczyny harmonogramu konserwacji, który określa przyczynę okna obsługi.

Dopuszczalne wartości dla tego parametru to:

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

Wskazuje, czy harmonogram ma zastosowanie do zasobu najwyższego poziomu, czy do wszystkich zawartych zasobów. Jeśli parametr cykliczny ma wartość false, tylko określony zasób przejdzie w tryb konserwacji po uruchomieniu harmonogramu. Jeśli zostanie ustawiona wartość true, określony zasób i wszystkie zasoby, które mają relację powstrzymywania z tym zasobem, również przejdzie w tryb konserwacji.

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

-SCSession

Określa tablicę obiektów Połączenia .

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Udostępnij za pośrednictwem

New-SCOMMaintenanceSchedule

Składnia

Opis

Przykłady

Przykład 1. Dodawanie obiektu komputera z systemem Windows do nowego harmonogramu konserwacji

Przykład 2. Tworzenie dziennego harmonogramu konserwacji

Przykład 3. Tworzenie cotygodniowego harmonogramu konserwacji

Przykład 4. Tworzenie miesięcznego harmonogramu konserwacji

Parametry

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

Dodatkowe zasoby

Udostępnij za pośrednictwem

New-SCOMMaintenanceSchedule

Składnia

Opis

Przykłady

Przykład 1. Dodawanie obiektu komputera z systemem Windows do nowego harmonogramu konserwacji

Przykład 2. Tworzenie dziennego harmonogramu konserwacji

Przykład 3. Tworzenie cotygodniowego harmonogramu konserwacji

Przykład 4. Tworzenie miesięcznego harmonogramu konserwacji

Parametry

-ActiveEndDate

-ActiveStartTime

-Comments

-ComputerName

-Confirm

-Credential

-Duration

-Enabled

-FreqInterval

-FreqRecurrenceFactor

-FreqRelativeInterval

-FreqType

-MonitoringObjects

-Name

-ReasonCode

-Recursive

-SCSession

-WhatIf

Linki powiązane

Dodatkowe zasoby