Dela via

New-SCOMMaintenanceSchedule

  • Referens
Modul:
OperationsManager

Skapar ett underhållsschema.

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

Cmdleten New-SCOMMaintenanceSchedule skapar ett underhållsschema.

När en resurs är i underhållsläge undertrycker Operations Manager aviseringar, meddelanden, regler, övervakare, automatiska svar, tillståndsändringar och nya aviseringar. Ett underhållsschema kan användas för att schemalägga en uppsättning resurser för att gå in i underhållsläge.

Du kan använda den här cmdleten för att skapa scheman som körs en gång, varje dag, varje vecka eller varje månad en viss dag eller en dag i veckan. Den här cmdleten returnerar GUID för det skapade schemat.

Som standard använder den här cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Exempel

Exempel 1: Lägg till Windows-datorobjekt i nytt underhållsschema

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

Exempel som visar hur du lägger till ett Windows-datorobjekt för en specifik server: Agent01.contoso.com i det nya underhållsschemat, under 240 minuter, som bara körs 1 gång.

Exempel 2: Skapa ett schema för dagligt underhåll

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

Exempel som visar hur du konfigurerar ett schema för dagligt underhåll för en specifik server och associerade övervakningsobjekt: Agent01.contoso.local, med start kl. 01:00 och varar i 90 minuter.

Exempel 3: Skapa ett veckovis underhållsschema

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

Exempel som visar hur du konfigurerar ett veckovis underhållsschema varje onsdag för en specifik server och associerade övervakningsobjekt: Agent01.contoso.local, med början kl. 02:00 och varar i 120 minuter.

Exempel 4: Skapa ett månatligt underhållsschema

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

Exempel som visar hur du upprättar ett månatligt underhållsschema den andra tisdagen i varje månad för en specifik server och associerade övervakningsobjekt: Agent01.contoso.local, med start kl. 03:00 och varar i 180 minuter.

Parametrar

-ActiveEndDate

Anger slutdatum och sluttid när schemat ska sluta köras. Om den här parametern inte anges fortsätter schemat att köras för alltid (eller tills det tas bort eller inaktiveras).

Om du till exempel vill skapa ett schema som ska avslutas den 1 maj 2016 kl. 09:00 måste du ange "01-05-2016 09:00:00" som ActiveEndDate. Du kan skicka en sträng som anger vilken tid du vill ha i din lokala tid. Men om du vill ange en UTC-tid bör du ange ett DateTime- objekt med DateTimeKind inställt på UTC.

Typ:DateTime
Position:5
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ActiveStartTime

Anger startdatum och den tid då schemat måste vara aktivt. Om du till exempel vill skapa ett schema som ska börja från och med den 1 maj 2016 och måste köras kl. 09:00 måste du ange "01-05-2016 09:00:00" som ActiveStartTime. Du kan skicka en sträng som anger vilken tid du vill ha i din lokala tid. Men om du vill ange en UTC-tid måste du ange ett DateTime--objekt med DateTimeKind inställt på UTC.

Typ:DateTime
Position:4
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Comments

Anger alla kommentarer som kan läsas av människor för ett underhållsschema.

Typ:String
Position:8
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste vara aktiv på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett PSCredential- objekt för hanteringsgruppens anslutning. Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential. Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Duration

Anger varaktigheten för underhållsschemat. Varaktigheten för ett underhållsschema är den tid för vilken underhållsschemat kommer att vara.

Typ:Int32
Alias:DurationInMinutes
Position:6
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Enabled

Anger om schemat ska aktiveras eller inaktiveras när det skapas. Om du anger detta till false skapas schemat, men det inaktiveras.

Typ:SwitchParameter
Position:2
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FreqInterval

Anger när jobbet ska köras. Den här parametern kan vara ett av följande värden:

  • 1 (en gång). Frekvensintervallet används inte.
  • 4 (dagligen). Varje frekvensintervalldagar.
  • 8 (varje vecka). Parametern FreqInterval är en eller flera av följande (kombinerat med en logisk OR-operator):
    • 1 - söndag
    • 2 – måndag
    • 4 - tisdag
    • 8 - onsdag
    • 16 - torsdag
    • 32 - fredag
    • 64 - lördag
  • 16 (månadsvis). På frekvensintervallets dag i månaden.
    • 1 - söndag
    • 2 – måndag
    • 3 – tisdag
    • 4 - onsdag
    • 5 - torsdag
    • 6 - fredag
    • 7 - lördag
  • 32 (månatlig relativ). Parametern FreqInterval är ett av följande värden:
    • 8 - Dag
    • 9 - Veckodag
    • 10 - Helgdag
Typ:Int32
Position:10
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FreqRecurrenceFactor

Antal veckor eller månader mellan den schemalagda körningen av jobbet. FreqRecurrenceFactor används endast om parametern FreqType är inställd på 8, 16 eller 32. Parametern FreqRecurrenceFactor är ett heltal med standardvärdet 0.

Typ:Int32
Position:11
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FreqRelativeInterval

Dag då jobbet körs. Detta är obligatoriskt om schemat är något annat än OnceRecurrence schema. Värdet beror på värdet för FreqType.

Den här parametern kan vara ett av följande värden:

  • 1 (Först)
  • 2 (andra)
  • 4 (tredje)
  • 8 (fjärde)
  • 16 (senaste)
Typ:Int32
Position:12
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-FreqType

Anger när jobbet ska köras. De godtagbara värdena för den här parametern är:

  • 1 (en gång)
  • 4 (dagligen)
  • 8 (varje vecka)
  • 16 (månadsvis)
  • 32 (Månatlig, i förhållande till parametern FreqInterval)
Typ:Int32
Position:9
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MonitoringObjects

Anger en matris med GUIDS för övervakningsobjekt som ska placeras i underhållsläge. Om du vill ange ett övervakningsobjekt som det skapade schemat ska placera i underhållsläge måste du skicka ID-attributet för övervakningsobjektet.

Du kan ange ett eller flera övervakningsobjekt för ett schema. Du kan dock inte skapa ett schema utan övervakningsobjekt.

Typ:Guid[]
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på det schema som den här cmdleten skapar.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ReasonCode

Anger orsakskoden för ett underhållsschema som anger orsaken till underhållsfönstret.

De godtagbara värdena för den här parametern är:

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • OplaneradHardwareMaintenance
  • PlannedHardwareInstallation
  • OplaneradHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • OplaneradApplicationMaintenance
  • ApplicationInstallation
  • ApplicationUnresponsive
  • ApplicationUnstable
  • SecurityIssue
  • LossOfNetworkConnectivity
Typ:MaintenanceModeReason
Godkända värden:PlannedOther, UnplannedOther, PlannedHardwareMaintenance, UnplannedHardwareMaintenance, PlannedHardwareInstallation, UnplannedHardwareInstallation, PlannedOperatingSystemReconfiguration, UnplannedOperatingSystemReconfiguration, PlannedApplicationMaintenance, UnplannedApplicationMaintenance, ApplicationInstallation, ApplicationUnresponsive, ApplicationUnstable, SecurityIssue, LossOfNetworkConnectivity
Position:7
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Recursive

Anger om schemat gäller för resursen på den översta nivån eller för alla inneslutna resurser. Om den rekursiva parametern är inställd på false går endast den angivna resursen i underhållsläge när schemat körs. Om detta är inställt på sant, kommer den angivna resursen och alla resurser som har en inneslutningsrelation med den här resursen också att gå i underhållsläge.

Typ:SwitchParameter
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False