Share via


New-AzureAutomationSchedule

Automation スケジュールを作成します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

New-AzureAutomationSchedule
   -Name <String>
   -StartTime <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -DayInterval <Byte>
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureAutomationSchedule
   -Name <String>
   -StartTime <DateTimeOffset>
   [-Description <String>]
   [-OneTime]
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureAutomationSchedule
   -Name <String>
   -StartTime <DateTimeOffset>
   [-Description <String>]
   [-ExpiryTime <DateTimeOffset>]
   -HourInterval <Byte>
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

説明

重要

Azure Automation 用のこの PowerShell コマンドは、2020 年 1 月 23 日の時点でサポートされなくなりました。 Azure サービス管理モデルは Azure Automation では非推奨となり、その日に無効になりました。 Az.Automation で Azure Resource Management モデルをサポートするコマンドを使用してください。

New-AzureAutomationSchedule コマンドレットは、Microsoft Azure Automation でスケジュールを作成します。

例 1: 1 回限りスケジュールを作成する

PS C:\> New-AzureAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime

次のコマンドは、現在の日付の午後 11:00 に 1 回実行されるスケジュールを作成します。

例 2: 定期的なスケジュールを作成する

PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DailyInterval 1

次のコマンドは、毎日午後 1 時に現在の日から 1 年間実行される新しいスケジュールを作成します。

パラメーター

-AutomationAccountName

Automation アカウントの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DayInterval

スケジュールの間隔を日数で指定します。

Type:Byte
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:True
Accept wildcard characters:False

-ExpiryTime

スケジュールの有効期限を指定します。 有効な DateTime に変換できる場合は、文字列を指定できます。

Type:DateTimeOffset
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HourInterval

スケジュールの間隔を時間単位で指定します。

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

スケジュールの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OneTime

この操作によって 1 回限りスケジュールが作成されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

スケジュールの開始時刻を指定します。 有効な DateTime に変換できる場合は、文字列を指定できます。

Type:DateTimeOffset
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

出力

Schedule