New-SCServicingWindow

Modul:

VirtualMachineManager

Skapar en serviceperiod och schemat för serviceperioden.

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

Cmdleten New-SCServicingWindow skapar en serviceperiod och ett schema för serviceperioden. En serviceperiod är en schemalagd tidsram under vilken underhållsarbete kan utföras på en virtuell dator, en värd eller en tjänst.

Exempel

Exempel 1: Schemalägg en daglig serviceperiod

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

Det första kommandot hämtar det aktuella datumet och lägger till två dagar och lagrar sedan resultatet i variabeln $Date.

Det andra kommandot skapar ett servicefönster med namnet Backup Staging A som inträffar var tredje dag kl. 13:30 i GMT Standard-tidszonen. Startdatumet för serviceperioden är inställt på det datum som lagras i $Date, som infaller om två dagar.

Exempel 2: Schemalägg en serviceperiod som inträffar en dag i veckan

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

Det första kommandot hämtar det aktuella datumet och lägger till sju dagar (en vecka) och lagrar sedan resultatet i variabeln $Date.

Det andra kommandot skapar ett servicefönster med namnet Test Servers Group 3 som inträffar varje vecka på lördag med start kl. 11:00 i den östra tidszonen och varar i 3 timmar (180 minuter). Startdatumet för serviceperioden är inställt på det datum som lagras i $Date, som infaller om sju dagar (en vecka).

Exempel 3: Schemalägg ett servicefönster varannan vecka

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

Det här kommandot skapar ett servicefönster med namnet Mellanlagringsgrupp C som inträffar varannan vecka (varannan vecka) på lördag och söndag med start kl. 22:30 i den östra tidszonen. Eftersom inget startdatum har angetts börjar serviceperioden som standard gälla idag.

Exempel 4: Schemalägg en serviceperiod varannan månad

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

Det här kommandot skapar ett servicefönster med namnet Produktionsservrar A som inträffar varannan månad (varannan månad) den andra tisdagen i månaden, med början kl. 23:30 i den östra tidszonen. Eftersom inget startdatum har angetts börjar serviceperioden som standard gälla idag.

Parametrar

-Category

Anger en kategori för en serviceperiod.

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

-DayOfMonth

Anger den ordningstalsdag i månaden då schemat startar. 4 anger till exempel den fjärde dagen i månaden. Den sista anger den sista dagen i månaden.

Standardvärdet är det heltal som motsvarar samma dag som anges i parametern StartDate .

• Giltiga heltalsvärden: 1–31
• Giltiga strängvärden: Första, Sista

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

Anger hur lång tid, i dagar, mellan schemalagda jobb. Standardvärdet är det minsta värdet för ett (1). Det maximala värdet är 999.

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

-Description

Anger en beskrivning för serviceperioden.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-MinutesDuration

Anger en tidsperiod i minuter. Använd den här parametern för att ange hur lång tid en server eller tjänst ska placeras i underhållsläge.

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

-MonthlyScheduleDayOfWeek

Anger veckodagen för att köra ett jobb som inträffar enligt ett månatligt schema. Du kan bara ange en dag i veckan. Standardvärdet är den aktuella dagen (om idag är tisdag är tisdag standardvärdet). De acceptabla värdena för den här parametern är:

• Måndag
• Tisdag
• Onsdag
• Torsdag
• Fredag
• Lördag
• Söndag

Krav: Använd med parametern 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

Anger hur lång tid, i månader, mellan schemalagda serviceperioder. Standardvärdet är minimivärdet 1. Det finns inget högsta värde.

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

-Name

Anger namnet på ett VMM-objekt (Virtual Machine Manager).

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

-Owner

Anger ägaren av ett VMM-objekt i form av ett giltigt domänanvändarkonto.

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

-PROTipID

Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-StartDate

Anger datumet då ett tjänstfönster ska startas. Standardvärdet är det aktuella datumet. Du kan ange ett nytt datum i kort datumformat för dina nationella inställningar, eller så kan du skicka ett DateTime-objekt från Get-Date.

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

-StartTimeOfDay

Anger tid på dagen, eller ett tidsintervall under en 24-timmarsperiod, för att starta ett jobb eller en annan åtgärd. Standardvärdet är den aktuella tiden.

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

-TimeZone

Anger ett tal (ett index) som identifierar en geografisk region som delar samma standardtid. En lista över tidszonsindex finns i Microsoft Time Zone Index Values på http://go.microsoft.com/fwlink/?LinkId=120935. Om ingen tidszon anges är standardtidszonen som används för en virtuell dator samma tidszonsinställning som finns på den virtuella datorvärden.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

-WeeklyScheduleDayOfWeek

Anger en eller flera dagar i veckan för att köra ett jobb. Standardvärdet är den aktuella veckodagen.

• Giltiga värden för att ange en enskild dag med hjälp av en sträng: Måndag, Tisdag, Onsdag, Torsdag, Fredag, Lördag, Söndag.
• Giltiga värden för att ange en uppsättning dagar i en vecka: Alla uppsättningar med två eller flera dagar avgränsade med kommatecken.
• Giltiga värden för att ange en enskild dag med hjälp av ett heltal: 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

Anger en vecka i förhållande till den första dagen i månaden, till exempel första, andra, tredje, fjärde eller sista.

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

Anger hur lång tid, i veckor, mellan schemalagda jobb. Standardvärdet är det minsta värdet för ett (1). Det finns inget högsta värde.

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

Utdata

ServicingWindow

Den här cmdleten returnerar ett ServicingWindow-objekt .

Relaterade länkar

• Get-SCServicingWindow
• Remove-SCServicingWindow
• Set-SCServicingWindow