New-AzAutomationConnection

  • Referência
Módulo:
Az.Automation

Cria uma conexão de automação.

Syntax

New-AzAutomationConnection
   [-Name] <String>
   [-ConnectionTypeName] <String>
   [-ConnectionFieldValues] <IDictionary>
   [-Description <String>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzAutomationConnection cria uma conexão na Automação do Azure.

Exemplos

Exemplo 1: Criar uma conexão para ConnectionTypeName=Azure

$FieldValues = @{"AutomationCertificateName"="ContosoCertificate";"SubscriptionID"="81b59010-dc55-45b7-89cd-5ca26db62472"}
New-AzAutomationConnection -Name "Connection12" -ConnectionTypeName Azure -ConnectionFieldValues $FieldValues -ResourceGroupName "ResourceGroup01" -AutomationAccountName "AutomationAccount01"

O primeiro comando atribui uma tabela de hash de valores de campo à variável $FieldValue. O segundo comando cria uma conexão do Azure chamada Connection12 na conta de automação chamada AutomationAccount01. O comando usa os valores do campo de conexão em $FieldValues.

Exemplo 2: Criar uma conexão para ConnectionTypeName=AzureServicePrincipal

$Thumbprint = "0SZTNJ34TCCMUJ5MJZGR8XQD3S0RVHJBA33Z8ZXV"
$TenantId = "4cd76576-b611-43d0-8f2b-adcb139531bf"
$ApplicationId = "3794a65a-e4e4-493d-ac1d-f04308d712dd"
$SubscriptionId = "81b59010-dc55-45b7-89cd-5ca26db62472"
$RunAsAccountConnectionFieldValues = @{"ApplicationId" = $ApplicationId; "TenantId" = $TenantId; "CertificateThumbprint" = $Thumbprint; "SubscriptionId" = $SubscriptionId}
New-AzAutomationConnection -Name "Connection13" -ConnectionTypeName AzureServicePrincipal -ConnectionFieldValues $RunAsAccountConnectionFieldValues -ResourceGroupName "ResourceGroup01" -AutomationAccountName "AutomationAccount01"

O comando cria uma conexão do Azure chamada Connection13 na conta de automação chamada AutomationAccount01 usando $RunAsAccountConnectionFieldValues e ConnectionTypeName=AzureServicePrincipal. Esse ConnectionTypeName=AzureServicePrincipal é usado principalmente para a Conta Run As do Azure.

Exemplo 3: Criar uma conexão para ConnectionTypeName=AzureClassicCertificate

$SubscriptionName = "MyTestSubscription"
$SubscriptionId = "81b59010-dc55-45b7-89cd-5ca26db62472"
$ClassicRunAsAccountCertifcateAssetName = "AzureClassicRunAsCertificate"
$ClassicRunAsAccountConnectionFieldValues = @{"SubscriptionName" = $SubscriptionName; "SubscriptionId" = $SubscriptionId; "CertificateAssetName" = $ClassicRunAsAccountCertifcateAssetName}
New-AzAutomationConnection -Name "Connection14" -ConnectionTypeName AzureClassicCertificate  -ConnectionFieldValues $ClassicRunAsAccountConnectionFieldValues -ResourceGroupName "ResourceGroup01" -AutomationAccountName "AutomationAccount01"

O comando cria uma conexão do Azure chamada Connection14 na conta de automação chamada AutomationAccount01 usando $ClassicRunAsAccountConnectionFieldValues e ConnectionTypeName=AzureClassicCertificate. Este ConnectionTypeName=AzureClassicCertificate é usado principalmente para a Conta Run As Clássica do Azure.

Parâmetros

-AutomationAccountName

Especifica o nome da conta de automação para a qual esse cmdlet cria uma conexão.

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

-ConnectionFieldValues

Especifica uma tabela de hash que contém pares chave/valor. As chaves representam os campos de conexão para o tipo de conexão especificado. Os valores representam os valores específicos de cada campo de conexão para a instância de conexão.

Type:IDictionary
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConnectionTypeName

Especifica o nome do tipo de conexão.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

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

-Description

Especifica uma descrição para a conexão.

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

-Name

Especifica um nome para a conexão.

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

-ResourceGroupName

Especifica o nome do grupo de recursos para o qual esse cmdlet cria uma conexão.

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

Entradas

String

IDictionary

Saídas

Connection