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 w trybie 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 w ciągu dnia 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 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, jak dodać obiekt 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 codziennego 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 tygodniowego 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, jak skonfigurować tygodniowy harmonogram konserwacji w każdą ś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ć wykonywać. 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 r. 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.

Typ:	DateTime
Position:	5
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 rozpoczynać 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 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.

Typ:	DateTime
Position:	4
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Comments

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

Typ:	String
Position:	8
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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żywa komputera dla bieżącego połączenia grupy zarządzania.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 bieżący użytkownik.

Typ:	PSCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Duration

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

Typ:	Int32
Aliasy:	DurationInMinutes
Position:	6
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	2
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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). Każdy interwał częstotliwości dni.
8 (co tydzień). Parametr FreqInterval jest co najmniej jeden 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 (miesięcznie). 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ń powszedni
- 10 — Dzień weekendowy

Typ:	Int32
Position:	10
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FreqRecurrenceFactor

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

Typ:	Int32
Position:	11
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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)

Typ:	Int32
Position:	12
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-FreqType

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

1 (raz)
4 (codziennie)
8 (co tydzień)
16 (co miesiąc)
32 (Miesięczne, względem parametru FreqInterval)

Typ:	Int32
Position:	9
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-MonitoringObjects

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

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

Typ:	Guid[]
Position:	3
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Name

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

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ReasonCode

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

Dopuszczalne wartości tego parametru to:

PlannedOther
NieplanowaneInne
PlannedHardwareMaintenance
UnplannedHardwareMaintenance
PlannedHardwareInstallation
UnplannedHardwareInstallation
PlannedOperatingSystemReconfiguration
UnplannedOperatingSystemReconfiguration
PlannedApplicationMaintenance
Nieplanowana aplikacjaMaintenance
ApplicationInstallation
AplikacjaUnresponsive
ApplicationUnstable
SecurityIssue
LossOfNetworkConnectivity

Typ:	MaintenanceModeReason
Dopuszczalne wartości:	PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:	7
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 do trybu konserwacji po uruchomieniu harmonogramu. Jeśli ta wartość ma wartość true, określony zasób i wszystkie zasoby, które mają relację ograniczenia z tym zasobem, również przejdzie w tryb konserwacji.

Typ:	SwitchParameter
Position:	1
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SCSession

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

Typ:	Connection[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 tygodniowego 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 tygodniowego 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