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

New-AzAutomationSchedule

创建自动化计划。

语法

ByDaily (默认值)

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

ByWeekly

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

ByMonthlyDaysOfMonth

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

ByMonthlyDayOfWeek

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

ByOneTime

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

ByHourly

New-AzAutomationSchedule
    [-Name] <String>
    [-StartTime] <DateTimeOffset>
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    -HourInterval <Byte>
    [-Description <String>]
    [-ExpiryTime <DateTimeOffset>]
    [-TimeZone <String>]
    [-ForUpdateConfiguration]
    [-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
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DayInterval

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

参数属性

类型:Byte
默认值:None
支持通配符:False
不显示:False

参数集

ByDaily
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DayOfWeek

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

参数属性

类型:

Nullable<T>[DayOfWeek]

默认值:None
接受的值:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
支持通配符:False
不显示:False

参数集

ByMonthlyDayOfWeek
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DayOfWeekOccurrence

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

  • 1
  • 2
  • 3
  • 4
  • -1
  • First
  • Second
  • 第三
  • 第四
  • LastDay

参数属性

类型:DayOfWeekOccurrence
默认值:None
接受的值:First, Second, Third, Fourth, Last
支持通配符:False
不显示:False

参数集

ByMonthlyDayOfWeek
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DaysOfMonth

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

参数属性

类型:

DaysOfMonth[]

默认值:None
接受的值: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
支持通配符:False
不显示:False

参数集

ByMonthlyDaysOfMonth
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DaysOfWeek

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

参数属性

类型:

DayOfWeek[]

默认值:None
接受的值:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
支持通配符:False
不显示:False

参数集

ByWeekly
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Description

指定计划的说明。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ExpiryTime

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

参数属性

类型:DateTimeOffset
默认值:None
支持通配符:False
不显示:False

参数集

ByDaily
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByWeekly
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByMonthlyDaysOfMonth
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByMonthlyDayOfWeek
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByHourly
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ForUpdateConfiguration

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-HourInterval

指定计划的间隔(以小时为单位)。

参数属性

类型:Byte
默认值:None
支持通配符:False
不显示:False

参数集

ByHourly
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MonthInterval

指定计划的间隔(以月份为单位)。

参数属性

类型:Byte
默认值:None
支持通配符:False
不显示:False

参数集

ByMonthlyDaysOfMonth
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
ByMonthlyDayOfWeek
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

指定计划的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-OneTime

指定 cmdlet 创建一次性计划。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

ByOneTime
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-StartTime

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

参数属性

类型:DateTimeOffset
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-TimeZone

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WeekInterval

为计划指定间隔(以周为单位)。

参数属性

类型:Byte
默认值:None
支持通配符:False
不显示:False

参数集

ByWeekly
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

DateTimeOffset

SwitchParameter

输出

Schedule