Set-SCServicingWindow

模块:

VirtualMachineManager

修改服务窗口的属性。

语法

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-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>]

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-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>]

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-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>]

Set-SCServicingWindow
   [-ServicingWindow] <ServicingWindow>
   [-Name <String>]
   [-Description <String>]
   [-Category <String>]
   [-Owner <String>]
   [-TimeZone <Int32>]
   [-StartDate <DateTime>]
   [-StartTimeOfDay <DateTime>]
   -DaysToRecur <Int32>
   [-MinutesDuration <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCServicingWindow cmdlet 修改服务窗口的属性，包括服务窗口的计划。

示例

示例 1：更改服务窗口的开始时间

PS C:\> $SvcWindow = Get-SCServicingWindow -Name "Backup Staging A" 
PS C:\> Set-SCServicingWindow -ServicingWindow $SvcWindow -StartTimeOfDay "13:00" -TimeZone 085

第一个命令获取名为 Backup Staging A 的服务窗口对象，并将该对象存储在$SvcWindow变量中。

第二个命令将存储在$SVCWINDOW (备份暂存 A) 的服务窗口的开始时间更改为 GMT 标准时区下午 1：00。

参数

-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 (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:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

-ServicingWindow

指定服务窗口对象。

Type:	ServicingWindow
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
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

-WeeklyScheduleDayOfWeek

指定要运行作业的一个或多个星期。 默认值为一周的当前日期。

使用字符串指定单个日期的有效值：星期一、星期二、星期三、星期四、星期五、星期六、星期日。

用于指定一周中的一组天数的有效值：用逗号分隔的两个或更多天的任意一组。

使用整数指定单个天的有效值：1、2、3、4、5、6、7

要求：与 StartTimeOfDay 一起使用。

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 对象。

相关链接

• Get-SCServicingWindow
• New-SCServicingWindow
• Remove-SCServicingWindow