Delen via

New-SCServicingWindow

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een onderhoudsvenster en de planning voor het onderhoudsvenster.

Syntaxis

New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -WeeklyScheduleDayOfWeek <String>
   [-WeeksToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -MonthlyScheduleDayOfWeek <DayOfWeek>
   -WeekOfMonth <WeekOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DayOfMonth <DayOfMonthType>
   [-MonthsToRecur <Int32>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCServicingWindow
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DaysToRecur <Int32>
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

De cmdlet New-SCServicingWindow maakt een onderhoudsvenster en het schema voor het onderhoudsvenster. Een onderhoudsvenster is een gepland tijdsbestek waarin onderhoudswerkzaamheden kunnen worden uitgevoerd op een virtuele machine, een host of een service.

Voorbeelden

Voorbeeld 1: Een dagelijks onderhoudsvenster plannen

PS C:\> $Date = (Get-Date).AddDays(2)
PS C:\> New-SCServicingWindow -Name "Backup Staging A" -Category "Non Essential" -StartDate $Date -StartTimeOfDay "13:30" -TimeZone 085 -DaysToRecur 3

De eerste opdracht haalt de huidige datum op en voegt twee dagen toe en slaat vervolgens het resultaat op in de $Date variabele.

Met de tweede opdracht maakt u een onderhoudsvenster met de naam Backup Staging A dat elke derde dag om 13:30 uur plaatsvindt in de standaardtijdzone van GMT. De begindatum van het onderhoudsvenster is ingesteld op de datum die is opgeslagen in $Date, die in twee dagen valt.

Voorbeeld 2: Een onderhoudsvenster plannen dat één dag per week plaatsvindt

PS C:\> $Date = (Get-Date).AddDays(7)
PS C:\> New-SCServicingWindow -Name "Test Servers Group 3" -Category "Test Group" -StartDate $Date -StartTimeOfDay "11:00" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday" -WeeksToRecur 1 -MinutesDuration 180

Met de eerste opdracht wordt de huidige datum ophaalt en zeven dagen (één week) toegevoegd, waarna het resultaat wordt opgeslagen in de variabele $Date.

Met de tweede opdracht maakt u een onderhoudsvenster met de naam TestServers Group 3 dat wekelijks plaatsvindt op zaterdag vanaf 11:00 uur in de oostelijke tijdzone en die gedurende 3 uur (180 minuten) duurt. De begindatum van het onderhoudsvenster is ingesteld op de datum die is opgeslagen in $Date, die in zeven dagen (één week) valt.

Voorbeeld 3: Een tweeweeks servicevenster plannen

PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2

Met deze opdracht maakt u een onderhoudsvenster met de naam Faseringsgroep C dat elke andere week (tweewekelijks) plaatsvindt op zaterdag en zondag vanaf 10:30 uur in de tijdzone Oost. Omdat er geen begindatum is opgegeven, wordt het onderhoudsvenster standaard van kracht vandaag.

Voorbeeld 4: Een tweemaandelijks onderhoudsvenster plannen

PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2

Met deze opdracht maakt u een onderhoudsvenster met de naam Productieservers A dat elke andere maand (tweemaandelijks) plaatsvindt op de tweede dinsdag van de maand, beginnend om 11:30 uur in de oostelijke tijdzone. Omdat er geen begindatum is opgegeven, wordt het onderhoudsvenster standaard van kracht vandaag.

Parameters

-Category

Hiermee geeft u een categorie voor een onderhoudsvenster.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DayOfMonth

Hiermee geeft u de rangschikkelijke dag van de maand waarop het schema begint. Bijvoorbeeld: 4 geeft de vierde dag van de maand aan. Laatste geeft de laatste dag van de maand aan.

De standaardwaarde is het gehele getal dat overeenkomt met dezelfde dag als opgegeven in de parameter StartDate.

  • Geldige gehele getallen: 1 - 31
  • Geldige tekenreekswaarden: Eerste, Laatste
Type:DayOfMonthType
Geaccepteerde waarden:First, DayTwo, DayThree, DayFour, DayFive, DaySix, DaySeven, DayEight, DayNine, DayTen, DayEleven, DayTweleve, DayThirteen, DayFourteen, DayFifteen, DaySixteen, DaySeventeen, DayEighteen, DayNineteen, DayTwenty, DayTwentyOne, DayTwentyTwo, DayTwentyThree, DayTwentyFour, DayTwentyFive, DayTwentySix, DayTwentySeven, DayTwentyEight, DayTwentyNine, DayThirty, DayThirtyOne, Last
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DaysToRecur

Hiermee geeft u de hoeveelheid tijd, in dagen, tussen geplande taken. De standaardwaarde is de minimumwaarde van één (1). De maximumwaarde is 999.

Type:Int32
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor het onderhoudsvenster.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinutesDuration

Hiermee geeft u een periode van tijd in minuten. Gebruik deze parameter om op te geven hoeveel tijd een server of service in de onderhoudsmodus moet worden geplaatst.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MonthlyScheduleDayOfWeek

Hiermee geeft u de dag van de week om een taak uit te voeren die plaatsvindt volgens een maandelijks schema. U kunt slechts één dag van de week opgeven. De standaardwaarde is de huidige dag (als het vandaag dinsdag is, is dinsdag de standaardwaarde). De acceptabele waarden voor deze parameter zijn:

  • Maandag
  • Dinsdag
  • Woensdag
  • Donderdag
  • Vrijdag
  • Zaterdag
  • Zondag

Vereiste: gebruik met de parameter WeekOfMonth.

Type:DayOfWeek
Geaccepteerde waarden:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MonthsToRecur

Hiermee geeft u de hoeveelheid tijd, in maanden, tussen geplande servicevensters. De standaardwaarde is de minimumwaarde van 1. Er is geen maximumwaarde.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object (Virtual Machine Manager).

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Owner

Hiermee geeft u de eigenaar van een VMM-object in de vorm van een geldig domeingebruikersaccount.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StartDate

Hiermee geeft u de datum op waarop een servicevenster moet worden gestart. De standaardwaarde is de huidige datum. U kunt een nieuwe datum typen in de korte datumnotatie voor uw landinstelling of u kunt een DateTime--object doorgeven vanuit Get-Date-.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StartTimeOfDay

Hiermee geeft u het tijdstip van de dag, of een tijdsduur gedurende een periode van 24 uur, op om een taak of andere bewerking te starten. De standaardwaarde is de huidige tijd.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeZone

Hiermee geeft u een getal (een index) aan dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op http://go.microsoft.com/fwlink/?LinkId=120935voor een lijst met tijdzone-indexen. Als er geen tijdzone is opgegeven, is de standaardtijdzone die wordt gebruikt voor een virtuele machine dezelfde tijdzone-instelling die zich op de host van de virtuele machine bevindt.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WeeklyScheduleDayOfWeek

Hiermee geeft u een of meer dagen van de week om een taak uit te voeren. De standaardwaarde is de huidige dag van de week.

  • Geldige waarden om een afzonderlijke dag op te geven met behulp van een tekenreeks: maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag, zondag.
  • Geldige waarden voor het opgeven van een set dagen in een week: elke set van twee of meer dagen gescheiden door komma's.
  • Geldige waarden voor het opgeven van een afzonderlijke dag met behulp van een geheel getal: 1, 2, 3, 4, 5, 6, 7
Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WeekOfMonth

Hiermee geeft u een week ten opzichte van de eerste dag van de maand, zoals eerste, tweede, derde, vierde of laatste.

Type:WeekOfMonthType
Geaccepteerde waarden:First, Second, Third, Fourth, Last
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WeeksToRecur

Hiermee geeft u de hoeveelheid tijd, in weken, tussen geplande taken. De standaardwaarde is de minimumwaarde van één (1). Er is geen maximumwaarde.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

ServicingWindow

Met deze cmdlet wordt een ServicingWindow--object geretourneerd.