你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzAutomationSchedule

模块:

Az.Automation

创建自动化计划。

语法

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-ExpiryTime <DateTimeOffset>]
   -WeekInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DaysOfMonth <DaysOfMonth[]>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-DayOfWeek <DayOfWeek>]
   [-DayOfWeekOccurrence <DayOfWeekOccurrence>]
   [-ExpiryTime <DateTimeOffset>]
   -MonthInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzAutomationSchedule
   [-Name] <String>
   [-StartTime] <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   [-TimeZone <String>]
   [-ForUpdateConfiguration]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

New-AzAutomationSchedule cmdlet 在 Azure 自动化 中创建计划。

示例

示例 1：在本地时间创建一次性计划

$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

第一个命令从系统获取时区 ID，并将其存储在$TimeZone变量中。 第二个命令创建一个计划，该计划在指定时区的当前日期下午 11：00 运行一次。

示例 2：在另一个时区创建一次性计划

$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone

第一个命令使用值 Europe/Paris 初始化$TimeZone变量。第二个命令创建一个计划，该计划在指定时区的当前日期为 23：00 UTC 运行一次。

注意：计划 StartTime 是通过将 TimeZone Offset 添加到提供的 StartTime 来计算的

示例 3：创建定期计划

$StartTime = Get-Date "13:00:00"
$EndTime = $StartTime.AddYears(1)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"

第一个命令使用 Get-Date cmdlet 创建日期对象，然后将对象存储在$StartDate变量中。 指定一个在将来至少五分钟的时间。 第二个命令使用 Get-Date cmdlet 创建日期对象，然后将对象存储在$EndDate变量中。 该命令指定一个未来的时间。 最后一个命令创建一个名为 Schedule02 的每日计划，以在存储在$StartDate的时间开始，并在存储在$EndDate的时间过期。

示例 4：创建每周定期计划

$StartTime = (Get-Date "13:00:00").AddDays(1)
[System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule03" -StartTime $StartTime -WeekInterval 1 -DaysOfWeek $WeekDays -ResourceGroupName "ResourceGroup01"

第一个命令使用 Get-Date cmdlet 创建日期对象，然后将对象存储在$StartDate变量中。 第二个命令创建包含星期一、星期二、星期三、星期四和星期五的星期几的数组。 最后一个命令创建一个名为 Schedule03 的每日计划，该计划将在每周 13：00 运行星期一到星期五。 计划永远不会过期。

参数

-AutomationAccountName

指定此 cmdlet 为其创建计划的自动化帐户的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DayInterval

指定计划的间隔（以天为单位）。 如果未指定此参数，并且未指定 OneTime 参数，则默认值为 1（1）。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DayOfWeek

为每周计划指定一周中的天数列表。

类型:	Nullable<T>[DayOfWeek]
接受的值:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DayOfWeekOccurrence

指定计划运行月份中的一周的发生。 psdx_paramvalues

• 1
• 2
• 3
• 4
• -1
• 第一个
• 第二个
• 第三个
• 第四
• LastDay

类型:	DayOfWeekOccurrence
接受的值:	First, Second, Third, Fourth, Last
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DaysOfMonth

指定每月计划的月份天数列表。

类型:	DaysOfMonth[]
接受的值:	One, Two, Three, Four, Five, Six, Seventh, Eighth, Ninth, Tenth, Eleventh, Twelfth, Thirteenth, Fourteenth, Fifteenth, Sixteenth, Seventeenth, Eighteenth, Nineteenth, Twentieth, TwentyFirst, TwentySecond, TwentyThird, TwentyFourth, TwentyFifth, TwentySixth, TwentySeventh, TwentyEighth, TwentyNinth, Thirtieth, ThirtyFirst, LastDay
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DaysOfWeek

为每周计划指定一周中的天数列表。

类型:	DayOfWeek[]
接受的值:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

指定计划的说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ExpiryTime

将计划的到期时间指定为 DateTimeOffset 对象。 可以指定可转换为有效 DateTimeOffset 的字符串。

类型:	DateTimeOffset
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForUpdateConfiguration

指示此计划对象将用于计划软件更新配置

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-HourInterval

指定计划的间隔（以小时为单位）。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-MonthInterval

指定计划的间隔（以月份为单位）。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

指定计划的名称。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-OneTime

指定 cmdlet 创建一次性计划。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

指定此 cmdlet 为其创建计划的资源组的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-StartTime

将计划的开始时间指定为 DateTimeOffset 对象。 可以指定可转换为有效 DateTimeOffset 的字符串。 如果提供了 TimeZone，则通过添加输入时区的偏移量来计算 StartTime。

类型:	DateTimeOffset
Position:	3
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TimeZone

指定计划的时区。 此字符串可以是 IANA ID 或 Windows 时区 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-WeekInterval

为计划指定间隔（以周为单位）。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

String

DateTimeOffset

SwitchParameter

输出

Schedule

相关链接

• Get-AzAutomationSchedule
• Remove-AzAutomationSchedule
• Set-AzAutomationSchedule