New-SCServicingWindow
创建服务窗口和服务窗口的计划。
语法
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>] 说明
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变量中。
第二个命令创建一个名为“备份暂存 A”的服务窗口，该窗口在 GMT 标准时区下午 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变量中。
第二个命令创建一个名为“测试服务器组 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 表示月份的第四天。 最后一天表示月份的最后一天。
默认值是对应于 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
指定运行按月计划发生的作业的星期几。 只能指定一周中的一天。 默认值为当前 (（如果今天为星期二，星期二为默认) ）。 此参数的可接受值为：
- 星期一
- 星期二
- 星期三
- 星期四
- 星期五
- 星期六
- 星期日
要求：与 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 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业以异步方式运行，以便控件立即返回到命令 shell。
| 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
指定一个数字 (索引) ，该索引标识共享同一标准时间的地理区域。
有关时区索引的列表，请参阅 Microsoft 时区索引值。http://go.microsoft.com/fwlink/?LinkId=120935
如果未指定时区，则用于虚拟机的默认时区是虚拟机主机上的同一时区设置。
| 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 返回 ServiceingWindow 对象。