• Artigo

Ligações

 

Publicado: junho de 2016

Aplica-se a: Windows Azure Pack for Windows Server, System Center 2012 R2 Orchestrator

As Ligações de‎ Automation contêm as informações necessárias para ligar a um serviço ou aplicação a partir de um runbook. Estas informações são definidas no módulo da aplicação e, normalmente, incluem o nome de utilizador e a palavra-passe, bem como o computador ao qual deve estabelecer a ligação. Podem ser necessárias outras informações, como um certificado ou um ID de subscrição. As propriedades de uma ligação são armazenadas em segurança na base de dados do Automation e podem ser acedidas no runbook que contém a atividade de Get-AutomationConnection.

Cmdlets do Windows PowerShell

Os cmdlets na tabela seguinte são utilizados para criar e gerir credenciais com o Windows PowerShell no Service Management Automation.

Cmdlets

Descrição

Get-SmaConnection

Obtém os valores de cada campo numa determinada ligação.

Get-SmaConnectionField

Obtém as definições de campo para um determinado tipo de ligação.

Get-SmaConnectionType

Obtém os tipos de ligação disponíveis.

New-SmaConnection

Cria uma ligação nova.

Remove-SmaConnection

Remove uma ligação existente.

Set-SmaConnectionFieldValue

Define o valor de um determinado campo para uma ligação existente.

Atividades do Runbook

As atividades na tabela seguinte são utilizadas para aceder a ligações num runbook.

Atividades

Descrição

Get-AutomationConnection

Obtém uma ligação a utilizar num runbook.

Criar uma Ligação Nova

Para criar uma ligação nova através do portal de gestão

  1. Selecione a área de trabalho Automatização.

  2. Na parte superior da janela, clique em Ativos.

  3. Na parte inferior da janela, clique em Adicionar Definição.

  4. Clique em Adicionar Ligação.

  5. Na lista pendente Tipo de Ligação, selecione um tipo de ligação.

  6. Escreva um nome para a ligação na caixa Nome.

  7. Clique na seta para a direita.

  8. Escreva um valor para cada propriedade.

  9. Clique na marca de verificação para guardar a ligação.

Para criar uma ligação nova com o Windows PowerShell no Service Management Automation

Os comandos de exemplo seguintes criam uma ligação nova ao Virtual Machine Manager com o nome MyVMMConnection. Tenha em conta que utilizamos uma tabela hash para definir as propriedades da ligação. Isto deve-se ao facto de os diferentes tipos de ligações necessitarem de conjuntos de propriedades diferentes. Uma ligação de outro tipo utilizaria um conjunto de valores de campo diferente.

Para obter mais informações sobre as tabelas hash, consulte about_Hash_Tables.

$webServer = 'https://MyWebServer'
$port = 9090
$connectionName = 'MyConnection'
$fieldValues = @{"Username"="MyUser";"Password"="password";"ComputerName"="MyComputer"} 
New-SmaConnection –WebServiceEndpoint $webServer –port $port –Name $connectionName –ConnectionTypeName "VirtualMachineManager" –ConnectionFieldValues $fieldValues

Utilizar uma ligação num runbook

Utilize a atividade do Get-AutomationConnection para utilizar uma ligação num runbook. Esta atividade obtém os valores dos diferentes campos da ligação e devolve-os como uma tabela hash que pode ser utilizada com os comandos apropriados no runbook.

Para obter mais informações sobre as tabelas hash, consulte about_Hash_Tables.

O código de exemplo seguinte explica como utilizar uma ligação para indicar o nome do computador e as credenciais para um bloco do a8b7e82f-e3fc-4286-8570-8d5ded944b27#bkmk_InlineScript que executa comandos noutro computador.

$con = Get-AutomationConnection -Name 'MyConnection'
$securepassword = ConvertTo-SecureString -AsPlainText -String $con.Password -Force
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $con.Username, $securepassword
InlineScript {
   <Commands>
} -PSComputerName $con.ComputerName -PSCredential $cred