Share via


New-AzureAutomationAccount

New-AzureAutomationAccount

Creates an Automation account.

Syntax

Parameter Set: Default
New-AzureAutomationAccount [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-Plan <String> {Free | Basic} ] [-Profile <AzureProfile> ] [-Tags <IDictionary> ] [ <CommonParameters>]

Detailed Description

The New-AzureAutomationAccount cmdlet creates an Azure Automation account in a resource group.

An Automation account is a container for Automation resources that is isolated from the resources of other Automation accounts. Automation resources include runbooks, DSC configurations, jobs, and assets.

Parameters

-Location<String>

Specifies the location in which this cmdlet creates the Automation account. To obtain valid locations, use the Get-AzureLocation cmdlet.

Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies a name for the Automation account.

Aliases

AutomationAccountName

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Plan<String>

Specifies the plan for the Automation account. Valid values are: Basic and Free.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Profile<AzureProfile>

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ResourceGroupName<String>

Specifies the name of a resource group to which this cmdlet adds an Automation account.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

-Tags<IDictionary>

Specifies tags for the Automation account.

Aliases

Tag

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true(ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Create an automation account

This command creates a new automation account named MyAutomationAccount in the East US region.

PS C:\>  New-AzureAutomationAccount -Name "MyAutomationAccount" -Location "East US" -ResourceGroupName "ResourceGroup01"

Get-AzureAutomationAccount

Remove-AzureAutomationAccount

Set-AzureAutomationAccount

Get-AzureLocation