Compartilhar via

New-AzAutomationConnection

  • Referência
Módulo:
Az.Automation

Cria uma conexão de automação.

Sintaxe

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 = "00001111-aaaa-2222-bbbb-3333cccc4444"
$ApplicationId = "00001111-aaaa-2222-bbbb-3333cccc4444"
$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 Executar como 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. Esse ConnectionTypeName=AzureClassicCertificate é usado principalmente para a Conta Executar como Clássica do Azure.

Parâmetros

-AutomationAccountName

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:IDictionary
Cargo:4
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConnectionTypeName

Especifica o nome do tipo de conexão.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica um nome para a conexão.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

IDictionary

Saídas

Connection