< Back

New-AzureRmAutomationConnection

Tue Jan 29, 2019 9:32 pm

NAME New-AzureRmAutomationConnection



SYNOPSIS

Creates an Automation connection.





SYNTAX

New-AzureRmAutomationConnection [-ResourceGroupName] <String> [-AutomationAccountName] <String> [-Name] <String> [-ConnectionTypeName] <String>

[-ConnectionFieldValues] <IDictionary> [-DefaultProfile <IAzureContextContainer>] [-Description <String>] [<CommonParameters>]





DESCRIPTION

The New-AzureRmAutomationConnection cmdlet creates a connection in Azure Automation.





PARAMETERS

-AutomationAccountName <String>

Specifies the name of the Automation account for which this cmdlet creates a connection.



Required? true

Position? 1

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ConnectionFieldValues <IDictionary>

Specifies a hash table that contains key/value pairs. The keys represent the connection fields for the specified connection type. The values

represent the specific values of each connection field for the connection instance.



Required? true

Position? 4

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ConnectionTypeName <String>

Specifies the name of the connection type.



Required? true

Position? 3

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-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



-Description <String>

Specifies a description for the connection.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

Specifies a name for the connection.



Required? true

Position? 2

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ResourceGroupName <String>

Specifies the name of the resource group for which this cmdlet creates a connection.



Required? true

Position? 0

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.Connection







NOTES









Example 1: Create a connection



PS C:\\>$FieldValues = @{"AutomationCertificateName"="ContosoCertificate";"SubscriptionID"="81b59010-dc55-45b7-89cd-5ca26db62472"}

PS C:\\> New-AzureRmAutomationConnection -Name "Connection12" -ConnectionTypeName Azure -ConnectionFieldValues $FieldValues -ResourceGroupName

"ResourceGroup01" -AutomationAccountName "AutomationAccount01"



The first command assigns a hash table of field values to the $FieldValue variable.



The second command creates an Azure connection named Connection12 in the Automation account named AutomationAccount01. The command uses the

connection field values in $FieldValues.







RELATED LINKS

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

Get-AzureRmAutomationConnection

Remove-AzureRmAutomationConnection