Compartilhar via

  • Artigo

Conexões

 

Publicado: março de 2016

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

Uma conexão Automação contém as informações necessárias para se conectar a um serviço ou aplicativo de um runbook. Essas informações estão definidas no módulo para o aplicativo e normalmente incluem informações como o nome de usuário e senha, e o computador ao qual se conectar. Outras informações também podem ser requeridas, assim como um certificado ou uma ID de assinatura. As propriedades de uma conexão são armazenadas com segurança no banco de dados Automação e podem ser acessadas no runbook com a atividade Get-AutomationConnection.

Cmdlets do Windows PowerShell

Os cmdlets na tabela a seguir são usados para criar e gerenciar credenciais com o Windows PowerShell em Service Management Automation.

Cmdlets

Descrição

Get-SmaConnection

Recupera os valores de cada campo em uma determinada conexão.

Get-SmaConnectionField

Recupera as definições de campo para um determinado tipo de conexão.

Get-SmaConnectionType

Recupera os tipos de conexão disponíveis.

New-SmaConnection

Cria uma nova conexão.

Remove-SmaConnection

Remove uma conexão existente.

Set-SmaConnectionFieldValue

Define o valor de um determinado campo de uma conexão existente.

Atividades de runbook

As atividades na tabela a seguir são usadas para acessar conexões em um runbook.

Atividades

Descrição

Get-AutomationConnection

Obtém uma conexão para usar em um runbook.

Criar uma nova conexão

Para criar uma nova conexão com o portal de gerenciamento

  1. Selecione o espaço de trabalho Automação.

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

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

  4. Clique em Adicionar Conexão.

  5. Na lista suspensa Tipo de conexão, selecione um tipo de conexão.

  6. Digite um nome para a conexão na caixa Name.

  7. Clique na seta à direita.

  8. Digite um valor para cada propriedade.

  9. Clique na marca de seleção para salvar a conexão.

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

Os comandos de exemplo a seguir criam uma nova conexão do Virtual Machine Manager com o nome MyVMMConnection. Observe que usamos uma tabela de hash para definir as propriedades da conexão. Isso ocorre porque diferentes tipos de conexões exigem diferentes conjuntos de propriedades. Uma conexão de outro tipo usaria um conjunto diferente de valores de campo.

Para obter mais informações sobre tabelas de 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

Usando uma conexão em um runbook

Use a atividade Get-AutomationConnection para usar uma conexão em um runbook. Essa atividade recupera os valores dos campos diferentes na conexão e os retorna como uma tabela de hash que pode ser usada com os comandos apropriados no runbook.

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

O código de exemplo a seguir mostra como usar uma conexão para fornecer o nome do computador e as credenciais para um bloco a8b7e82f-e3fc-4286-8570-8d5ded944b27#bkmk_InlineScript que executa comandos em outro 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