New-AzureRMAutomationSchedule
Automation スケジュールを作成します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
-DayInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DaysOfWeek <DayOfWeek[]>]
[-ExpiryTime <DateTimeOffset>]
-WeekInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-DaysOfMonth <DaysOfMonth[]>]
[-ExpiryTime <DateTimeOffset>]
-MonthInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-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-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-OneTime]
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] New-AzureRMAutomationSchedule
[-Name] <String>
[-StartTime] <DateTimeOffset>
[-Description <String>]
[-ExpiryTime <DateTimeOffset>]
-HourInterval <Byte>
[-TimeZone <String>]
[-ForUpdateConfiguration]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
New-AzureRmAutomationSchedule コマンドレットは、Azure Automation でスケジュールを作成します。
例
例 1: 現地時刻で 1 回限りスケジュールを作成する
PS C:\> $TimeZone = ([System.TimeZoneInfo]::Local).Id
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule01" -StartTime "23:00" -OneTime -ResourceGroupName "ResourceGroup01" -TimeZone $TimeZone最初のコマンドは、システムからタイム ゾーン ID を取得し、$TimeZone変数に格納します。 2 番目のコマンドは、指定したタイム ゾーンの午後 11 時に現在の日付に対して 1 回実行されるスケジュールを作成します。
例 2: 定期的なスケジュールを作成する
PS C:\> $StartTime = Get-Date "13:00:00"
PS C:\> $EndTime = $StartTime.AddYears(1)
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule02" -StartTime $StartTime -ExpiryTime $EndTime -DayInterval 1 -ResourceGroupName "ResourceGroup01"最初のコマンドは、Get-Date コマンドレットを使用して日付オブジェクトを作成し、そのオブジェクトを $StartDate 変数に格納します。 5 分以上後の時刻を指定します。 2 番目のコマンドは、Get-Date コマンドレットを 使用して日付 オブジェクトを作成し、そのオブジェクトを $EndDate 変数に格納します。 コマンドは、将来の時刻を指定します。 最後のコマンドでは、schedule02 という名前の日次スケジュールが作成され、$StartDateに格納された時刻に開始され、$EndDateに格納された時刻に有効期限が切れます。
例 3: 週単位の定期的なスケジュールを作成する
PS C:\> $StartTime = (Get-Date "13:00:00").AddDays(1)
PS C:\> [System.DayOfWeek[]]$WeekDays = @([System.DayOfWeek]::Monday..[System.DayOfWeek]::Friday)
PS C:\> New-AzureRmAutomationSchedule -AutomationAccountName "Contoso17" -Name "Schedule03" -StartTime $StartTime - WeekInterval 1 -DaysOfWeek $WeekDays -ResourceGroupName "ResourceGroup01"最初のコマンドは、Get-Date コマンドレットを使用して日付オブジェクトを作成し、そのオブジェクトを $StartDate 変数に格納します。 2 番目のコマンドは、月曜日、火曜日、水曜日、木曜日、金曜日を含む曜日の配列を作成します。 最後のコマンドは、毎週月曜日から金曜日の 13:00 に実行される Schedule03 という名前の毎日のスケジュールを作成します。 スケジュールは期限切れになりません。
パラメーター
-AutomationAccountName
このコマンドレットでスケジュールを作成する Automation アカウントの名前を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-DayInterval
スケジュールの間隔を日数で指定します。 このパラメーターを指定せず、OneTime パラメーターを指定しない場合、既定値は 1 です。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DayOfWeek
週単位のスケジュールの曜日の一覧を指定します。
| 型: | Nullable<T>[DayOfWeek] |
| 指定可能な値: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DayOfWeekOccurrence
スケジュールが実行される月内の週の発生を指定します。 psdx_paramvalues
- 1
- 2
- 3
- 4
- -1
- 最初
- Second
- Third
- 4 番目
- LastDay
| 型: | DayOfWeekOccurrence |
| 指定可能な値: | First, Second, Third, Fourth, Last |
| 配置: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DaysOfWeek
週単位のスケジュールの曜日の一覧を指定します。
| 型: | DayOfWeek[] |
| 指定可能な値: | Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
| 型: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
スケジュールの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ExpiryTime
スケジュールの有効期限を DateTimeOffest オブジェクトとして指定します。 有効な DateTimeOffset に変換できる文字列を指定できます。
| 型: | DateTimeOffset |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForUpdateConfiguration
このスケジュール オブジェクトがソフトウェア更新プログラムの構成のスケジュール設定に使用されることを示します
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-HourInterval
スケジュールの間隔を時間単位で指定します。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MonthInterval
スケジュールの間隔を月単位で指定します。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
スケジュールの名前を指定します。
| 型: | String |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-OneTime
コマンドレットが 1 回限りのスケジュールを作成することを指定します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ResourceGroupName
このコマンドレットでスケジュールを作成するリソース グループの名前を指定します。
| 型: | String |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-StartTime
スケジュールの開始時刻を DateTimeOffset オブジェクトとして指定します。 有効な DateTimeOffset に変換できる文字列を指定できます。 TimeZone パラメーターを指定した場合、オフセットは無視され、指定されたタイム ゾーンが使用されます。
| 型: | DateTimeOffset |
| 配置: | 3 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-TimeZone
スケジュールのタイム ゾーンを指定します。 この文字列には、IANA ID または Windows タイム ゾーン ID を指定できます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WeekInterval
スケジュールの間隔を週単位で指定します。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |