New-AzAutomationSchedule
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 コマンドレットは、Azure Automation でスケジュールを作成します。
例
例 1: 現地時刻で 1 回限りスケジュールを作成する
$TimeZone = ([System.TimeZoneInfo]::Local).Id
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone最初のコマンドは、システムからタイム ゾーン ID を取得し、$TimeZone変数に格納します。 2 番目のコマンドは、指定したタイム ゾーンの午後 11 時に現在の日付に対して 1 回実行されるスケジュールを作成します。
例 2: 別のタイム ゾーンに 1 回限りスケジュールを作成する
$TimeZone = "Europe/Paris"
New-AzAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00Z" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone最初のコマンドは、値 Europe/Paris を使用して$TimeZone変数を初期化します。2 番目のコマンドは、指定されたタイム ゾーンの現在の日付の 23:00 UTC に 1 回実行されるスケジュールを作成します。
注: StartTime のスケジュールは、指定された StartTime に TimeZone オフセットを追加することによって計算されます。
例 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 コマンドレットを使用して日付オブジェクトを作成し、そのオブジェクトを $StartDate 変数に格納します。 5 分以上後の時刻を指定します。 2 番目のコマンドは、Get-Date コマンドレットを 使用して日付 オブジェクトを作成し、そのオブジェクトを $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 コマンドレットを使用して日付オブジェクトを作成し、そのオブジェクトを $StartDate 変数に格納します。 2 番目のコマンドは、月曜日、火曜日、水曜日、木曜日、金曜日を含む曜日の配列を作成します。 最後のコマンドは、毎週月曜日から金曜日の 13:00 に実行される Schedule03 という名前の毎日のスケジュールを作成します。 スケジュールは期限切れになりません。
パラメーター
-AutomationAccountName
このコマンドレットでスケジュールを作成する Automation アカウントの名前を指定します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DayInterval
スケジュールの間隔を日数で指定します。 このパラメーターを指定せず、OneTime パラメーターを指定しない場合、既定値は 1 です。
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DayOfWeek
週単位のスケジュールの曜日の一覧を指定します。
| Type: | Nullable<T>[DayOfWeek] |
| Accepted values: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DayOfWeekOccurrence
スケジュールが実行される月内の週の発生を指定します。 psdx_paramvalues
- 1
- 2
- 3
- 4
- -1
- 最初
- Second
- Third
- 4 番目
- LastDay
| Type: | DayOfWeekOccurrence |
| Accepted values: | First, Second, Third, Fourth, Last |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysOfMonth
月単位のスケジュールの月の日の一覧を指定します。
| Type: | DaysOfMonth[] |
| Accepted values: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysOfWeek
週単位のスケジュールの曜日の一覧を指定します。
| Type: | DayOfWeek[] |
| Accepted values: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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
スケジュールの有効期限を DateTimeOffset オブジェクトとして指定します。 有効な DateTimeOffset に変換できる文字列を指定できます。
| Type: | DateTimeOffset |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForUpdateConfiguration
このスケジュール オブジェクトがソフトウェア更新プログラムの構成のスケジュール設定に使用されることを示します
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-HourInterval
スケジュールの間隔を時間単位で指定します。
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MonthInterval
スケジュールの間隔を月単位で指定します。
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
スケジュールの名前を指定します。
| Type: | String |
| Position: | 2 |
| 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 |
-ResourceGroupName
このコマンドレットでスケジュールを作成するリソース グループの名前を指定します。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StartTime
スケジュールの開始時刻を DateTimeOffset オブジェクトとして指定します。 有効な DateTimeOffset に変換できる文字列を指定できます。 TimeZone が指定されている場合、StartTime は入力タイムゾーンのオフセットを追加することによって計算されます。
| Type: | DateTimeOffset |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TimeZone
スケジュールのタイム ゾーンを指定します。 この文字列には、IANA ID または Windows タイム ゾーン ID を指定できます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WeekInterval
スケジュールの間隔を週単位で指定します。
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
出力
関連リンク
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示