Edit

New-AzAutomationAccount

  • Reference
Module:
Az.Automation

Creates an Automation account.

Syntax

New-AzAutomationAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [-Plan <String>]
   [-Tags <IDictionary>]
   [-AssignSystemIdentity]
   [-AssignUserIdentity <String[]>]
   [-AutomationServicesEncryption]
   [-DisablePublicNetworkAccess]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzAutomationAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [-Plan <String>]
   [-Tags <IDictionary>]
   [-AssignSystemIdentity]
   [-AssignUserIdentity <String[]>]
   [-KeyVaultEncryption]
   -KeyName <String>
   -KeyVersion <String>
   -KeyVaultUri <String>
   [-UserIdentityEncryption <String>]
   [-DisablePublicNetworkAccess]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

The New-AzAutomationAccount 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.

Examples

Example 1: Create an automation account

New-AzAutomationAccount -Name "ContosoAutomationAccount" -Location "East US" -ResourceGroupName "ResourceGroup01"

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

Example 2

Creates an Automation account. (autogenerated)

New-AzAutomationAccount -Location 'East US' -Name 'ContosoAutomationAccount' -ResourceGroupName 'ResourceGroup01' -Tags <IDictionary>

Parameters

-AssignSystemIdentity

Generate and assign a new System Identity for this automation account

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

-AssignUserIdentity

Assign the User Assigned Identities to this automation account

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AutomationServicesEncryption

Specify whether set Automation Account KeySource to Microsoft.Automation or not.

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

-DefaultProfile

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

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

-DisablePublicNetworkAccess

Whether to disable traffic on the non-ARM endpoints (Webhook/Agent) from the public internet

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

-KeyName

CMK KeyName

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

-KeyVaultEncryption

Specifiy whether set Automation Account KeySource to Microsoft.KeyVault (enable CMK) or not.

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

-KeyVaultUri

CMK KeyVaultUri

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

-KeyVersion

CMK KeyVersion

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

-Location

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

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

-Name

Specifies a name for the Automation account.

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

-Plan

Specifies the plan for the Automation account. Valid values are:

  • Basic
  • Free
Type:String
Accepted values:Free, Basic
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

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

-Tags

Key-value pairs in the form of a hash table. For example: @{key0="value0";key1=$null;key2="value2"}

Type:IDictionary
Aliases:Tag
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserIdentityEncryption

User Assigned Identity used for encryption

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

Inputs

String

IDictionary

Outputs

AutomationAccount