< Back

New-AzureRmAutomationAccount

Tue Jan 29, 2019 9:32 pm

NAME New-AzureRmAutomationAccount



SYNOPSIS

Creates an Automation account.





SYNTAX

New-AzureRmAutomationAccount [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-DefaultProfile <IAzureContextContainer>] [-Plan

{Free | Basic}] [-Tags <IDictionary>] [<CommonParameters>]





DESCRIPTION

The New-AzureRmAutomationAccount 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, Desired State Configuration (DSC) configurations, jobs, and assets.





PARAMETERS

-DefaultProfile <IAzureContextContainer>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Location <String>

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



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

Specifies a name for the Automation account.



Required? true

Position? 1

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



- Free



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ResourceGroupName <String>

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



Required? true

Position? 0

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Tags <IDictionary>

Key-value pairs in the form of a hash table. For example:



@{key0="value0";key1=$null;key2="value2"}



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

Microsoft.Azure.Commands.Automation.Model.AutomationAccount







NOTES









Example 1: Create an automation account



PS C:\\> New-AzureRmAutomationAccount -Name "ContosoAutomationAccount" -Location "East US" -ResourceGroupName "ResourceGroup01"



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







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... ionaccount

Get-AzureRmAutomationAccount

Remove-AzureRmAutomationAccount

Set-AzureRmAutomationAccount