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 på 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 SCSession-parametern 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 . För mer information ange 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 dagligt underhållsschema för en specifik server och associerade övervakningsobjekt: Agent01.contoso.local, med början kl. 01:00 och varar i 90 minuter.

Exempel 3: Skapa ett schema för veckounderhåll

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 början 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 den tas bort eller inaktiveras).

Om du till exempel vill skapa ett schema som ska sluta den 1 maj 2016 kl. 9: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 tidpunkt då schemat måste aktiveras. Om du till exempel vill skapa ett schema som ska börja den 1 maj 2016 och måste köras kl. 9: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 eventuella 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. Standard ä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 pågå.

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 ställer in detta på 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). FreqInterval-parametern ä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 släkting). FreqInterval-parametern ä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 FreqType-parametern ä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-schemat . 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 (sista)
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 acceptabla värdena för den här parametern är:

  • 1 (en gång)
  • 4 (dagligen)
  • 8 (varje vecka)
  • 16 (månadsvis)
  • 32 (Månadsvis, 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 övervakningsobjekt GUIDS som ska placeras i underhållsläge. Om du vill ange ett övervakningsobjekt som det skapade schemat ska försätta 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 acceptabla värdena för den här parametern är:

  • PlannedOther
  • UnplannedOther
  • PlannedHardwareMaintenance
  • UnplannedHardwareMaintenance
  • PlannedHardwareInstallation
  • UnplannedHardwareInstallation
  • PlannedOperatingSystemReconfiguration
  • UnplannedOperatingSystemReconfiguration
  • PlannedApplicationMaintenance
  • UnplannedApplicationMaintenance
  • 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 kommer endast den angivna resursen att gå i underhållsläge när schemat körs. Om detta är inställt på sant går den angivna resursen och alla resurser som har en inneslutningsrelation med den här resursen också 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 anslutningsobjekt .

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ördes. Cmdleten körs inte.

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