Register-AzureRMAutomationScheduledRunbook

Reference

Module:: AzureRM.Automation

Associates a runbook to a schedule.

Caution

Because Az PowerShell modules now have all the capabilities of AzureRM PowerShell modules and more, we'll retire AzureRM PowerShell modules on 29 February 2024.

To avoid service interruptions, update your scripts that use AzureRM PowerShell modules to use Az PowerShell modules by 29 February 2024. To automatically update your scripts, follow the quickstart guide.

Syntax

Register-AzureRMAutomationScheduledRunbook
        [-ResourceGroupName] <String>
        [-AutomationAccountName] <String>
        [-DefaultProfile <IAzureContextContainer>]
        [<CommonParameters>]

Register-AzureRMAutomationScheduledRunbook
        -RunbookName <String>
        -ScheduleName <String>
        [-Parameters <IDictionary>]
        [-RunOn <String>]
        [-ResourceGroupName] <String>
        [-AutomationAccountName] <String>
        [-DefaultProfile <IAzureContextContainer>]
        [<CommonParameters>]

Description

The Register-AzureRmAutomationScheduledRunbook cmdlet associates an Azure Automation runbook to a schedule. The runbook starts based on the schedule you specify using the ScheduleName parameter.

Examples

Example 1: Associate a runbook with a schedule

PS C:\>Register-AzureRmAutomationScheduledRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ScheduleName "Sched01" -ResourceGroupName "ResourceGroup01"

This command associates the runbook named Runbk01 with the schedule named Sched01 in the Azure Automation account named Contoso17.

Parameters

-AutomationAccountName

Specifies an Automation account for the runbook on which this cmdlet operates.

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

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Parameters

Specifies a hash table of key/value pairs. The keys are runbook parameter names. The values are runbook parameter values. When the runbook starts in response to the associated schedule, these parameters are passed to the runbook.

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

-ResourceGroupName

Specifies the name of a resource group for the scheduled runbook.

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

-RunbookName

Specifies the name of the runbook that this cmdlet associates to a schedule.

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

-RunOn

The name of the hybrid runbook worker group.

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

-ScheduleName

Specifies the name of the schedule to which this cmdlet associates a runbook.

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

Inputs

String

Outputs

JobSchedule