New-SCServicingWindow
建立服務視窗和服務視窗的排程。
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
New-SCServicingWindow Cmdlet 會建立服務視窗和服務視窗的排程。 服務時段是排程的時間範圍，可在虛擬機器、主機或服務上完成維護工作。
範例
範例 1：排程每日服務時段
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第一個命令會取得目前的日期，並新增兩天，然後將結果儲存在$Date變數中。
第二個命令會建立名為 Backup Staging A 的服務視窗，該時段會在 GMT 標準時區的下午 1：30 下午 1：30 發生。 服務視窗的開始日期會設定為儲存在 $Date 中的日期，也就是兩天。
範例 2：排程每週一天發生的服務時段
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第一個命令會取得目前的日期，並將七天 (一周) ，然後將結果儲存在$Date變數中。
第二個命令會建立名為 Test Servers Group 3 的服務視窗，從東部時區上午 11：00 開始每週發生，並持續 3 小時 (180 分鐘) 。 服務視窗的開始日期會設定為儲存在 $Date 中的日期，也就是 7 天 (一周) 。
範例 3：排程雙周服務視窗
PS C:\> New-SCServicingWindow -Name "Staging Group C" -StartTimeOfDay "22:30" -TimeZone 035 -WeeklyScheduleDayOfWeek "Saturday, Sunday" -WeeksToRecur 2此命令會建立名為暫存群組 C 的服務視窗，該時段會在星期六和星期日的 (星期六和星期日下午 10：30 開始每隔一周) 一次。 因為未指定開始日期，所以根據預設，服務視窗會立即生效。
範例 4：排程雙向服務視窗
PS C:\> New-SCServicingWindow -Name "Production Servers A" -Category "Emergency" -StartTimeOfDay "23:30" -TimeZone 085 -MonthlyScheduleDayOfWeek "Tuesday" -WeekOfMonth "Second" -MonthsToRecur 2此命令會建立名為「生產伺服器 A」的服務視窗，該視窗會在一個月的第二個星期二 (每星期二) 一次，從東部時區的下午 11：30 開始。 因為未指定開始日期，所以根據預設，服務視窗會立即生效。
參數
-Category
指定服務視窗的類別。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DayOfMonth
指定排程開始之月份的序數日。 例如，4 表示月份的第四天。 Last 表示月份的最後一天。
預設值是對應于 StartDate 參數中所指定日期的整數。
- 有效的整數值：1 - 31
- 有效的字串值：First、Last
| 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
指定排程工作之間的時間量，以天為單位。 預設值是 1 (1) 的最小值。 最大值為 999。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定服務視窗的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinutesDuration
以分鐘為單位指定一段時間。 使用此參數來指定將伺服器或服務放入維護模式的時間量。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonthlyScheduleDayOfWeek
指定執行依每月排程發生的作業的星期幾。 您只能指定一周的一天。 如果今天是星期二，則預設值是目前日期 (，星期二是預設) 。 此參數可接受的值為：
- Monday
- Tuesday
- Wednesday
- Thursday
- 星期五
- 星期六
- 星期日
需求：搭配 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
指定排程服務時段之間的時間量，以月為單位。 預設值為最小值 1。 沒有最大值。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定 Virtual Machine Manager (VMM) 物件的名稱。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Owner
以有效網域使用者帳戶的格式指定 VMM 物件的擁有者。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDate
指定要啟動服務視窗的日期。 預設值是目前日期。 您可以使用地區設定的簡短日期格式輸入新日期，也可以從Get-Date傳遞DateTime物件。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartTimeOfDay
指定一天的時間，或 24 小時期間的時間範圍，以啟動作業或其他作業。 預設值為目前時間。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeZone
指定 (索引) 的數位，識別共用相同標準時間的地理區域。
如需時區索引的清單，請參閱 中的 http://go.microsoft.com/fwlink/?LinkId=120935Microsoft 時區索引值。
如果未指定時區，則用於虛擬機器的預設時區是虛擬機器主機上的相同時區設定。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WeeklyScheduleDayOfWeek
指定要執行作業的一或多個星期幾。 預設值為當周的目前日期。
- 使用字串指定個別日期的有效值：星期一、星期二、星期三、星期四、星期五、星期六、星期日。
- 有效值可指定一周中的一組天數：以逗號分隔的兩或多天的任何一組。
- 使用整數指定個別日期的有效值：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
指定一周相對於月份的第一天，例如第一天、第二天、第三天、第四天或最後一天。
| 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
指定排程工作之間的時間量，以周為單位。 預設值是 1 (1) 的最小值。 沒有最大值。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸出
ServicingWindow
此 Cmdlet 會傳回 ServicingWindow 物件。