Delen via

New-SCServicingWindow

  • Referentie
Module:
VirtualMachineManager

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

Syntax

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 de planning 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 gmt-standaardtijdzone. De begindatum van het onderhoudsvenster is ingesteld op de datum die is opgeslagen in $Date, wat in twee dagen is.

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

De eerste opdracht haalt de huidige datum op en voegt zeven dagen (één week) toe, 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 duurt deze gedurende 3 uur (180 minuten). De begindatum van het onderhoudsvenster is ingesteld op de datum die is opgeslagen in $Date, die in zeven dagen (één week) is opgeslagen.

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 (biweekly) op zaterdag en zondag plaatsvindt vanaf 10:30 uur in de oostelijke tijdzone. Omdat er geen begindatum is opgegeven, wordt het onderhoudsvenster standaard van kracht vandaag.

Voorbeeld 4: Een tweemaandelijkse 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 (tweemaandelijkse) 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DayOfMonth

Hiermee geeft u de rangschikkelijke dag van de maand waarop het schema begint. 4 geeft bijvoorbeeld 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 waarden voor gehele getallen: 1 - 31
  • Geldige tekenreekswaarden: Eerste, Laatste
Type:DayOfMonthType
Accepted values: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Hiermee geeft u een beschrijving voor het onderhoudsvenster.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinutesDuration

Hiermee geeft u een periode 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MonthlyScheduleDayOfWeek

Hiermee geeft u de dag van de week op 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 vandaag dinsdag, dinsdag de standaardwaarde is). De aanvaardbare waarden voor deze parameter zijn:

  • Maandag
  • Dinsdag
  • Woensdag
  • Donderdag
  • Vrijdag
  • Saturday
  • Sunday

Vereiste: gebruik met de parameter WeekOfMonth .

Type:DayOfWeek
Accepted values:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MonthsToRecur

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

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

-Name

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

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTimeOfDay

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

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

-TimeZone

Hiermee geeft u een getal (een index) dat een geografische regio identificeert die dezelfde standaardtijd deelt. Zie Microsoft Time Zone Index Values op voor een lijst met tijdzone-indexen op http://go.microsoft.com/fwlink/?LinkId=120935. 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Hiermee geeft u een VMM-serverobject op.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 voor het opgeven van een afzonderlijke dag 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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Accepted values:First, Second, Third, Fourth, Last
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WeeksToRecur

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

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

Uitvoerwaarden

ServicingWindow

Met deze cmdlet wordt een ServicingWindow-object geretourneerd.