Artigo
10/26/2015

Credenciais

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

Uma credencial Automação é um nome de usuário e senha que podem ser usados com comandos do Windows PowerShell ou então um certificado que é carregado no servidor. As propriedades de uma credencial são armazenadas com segurança no banco de dados Automação e podem ser acessadas no runbook com a atividade Get-AutomationPSCredential ou Get-AutomationCertificate.

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-SmaCertificate	Recupera um certificado Automação.
Get-SmaCredential	Recupera uma credencial Automação do PowerShell.
Remove-SmaCertificate	Remove um certificado Automação.
Remove-SmaCredential	Remove uma credencial Automação do PowerShell.
Set-SmaCertificate	Cria um novo certificado ou define as propriedades de um certificado existente, incluindo o carregamento do arquivo de certificado e a configuração da senha para um .pfx.
Set-SmaCredential	Cria uma nova credencial Automação do PowerShell ou define as propriedades de uma credencial existente.

Atividades de runbook

As atividades na tabela a seguir são usadas para acessar as credenciais em um runbook.

Atividades	Descrição
Get-AutomationCertificate	Obtém um certificado para uso em um runbook.
Get-AutomationPSCredential	Obtém uma nome de usuário/senha a serem usados em um runbook.

Observação
Você deve evitar usar variáveis no parâmetro –Name de Get-AutomationPSCredential e Get-AutomationCertificate, já que isso pode complicar a descoberta de dependências entre runbooks e variáveis Automação.

Criando uma nova credencial

Para criar uma nova credencial do PowerShell com o Portal de gerenciamento

Selecione o espaço de trabalho Automação.
Na parte superior da janela, clique em Ativos.
Na parte inferior da janela, clique em Adicionar configuração.
Clique em Adicionar Credencial.
No menu suspenso Tipo de Credencial, selecione Credencial do PowerShell.
Digite um nome para a credencial na caixa Nome.
Clique na seta à direita.
Digite valores para cada propriedade.
Clique na marca de seleção para salvar a credencial.

Para criar um novo certificado com o Portal de gerenciamento

Selecione o espaço de trabalho Automação.
Na parte superior da janela, clique em Ativos.
Na parte inferior da janela, clique em Adicionar configuração.
Clique em Adicionar Credencial.
No menu suspenso Tipo de Credencial, selecione Certificado.
Digite um nome para o certificado na caixa Nome.
Clique na seta à direita.
Clique em Procurar arquivo e navegue até um arquivo .cer ou .pfx.
Se você selecionou um arquivo .pfx, forneça sua senha.
Clique na marca de seleção para salvar o certificado.

Para criar uma nova credencial do PowerShell com o Windows PowerShell no Service Management Automation

Os seguintes comandos de exemplo mostram como criar uma nova credencial.

$webServer = 'https://MyWebServer'
$port = 9090
$credName = 'MyCredential'
$user = 'contoso\MyUser'
$pwd = ConvertTo-SecureString -String 'P@$$w0rd' -AsPlainText -Force
$cred = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $user,$pwd

Set-SmaCredential -WebServiceEndpoint $webServer -port $port -Name $credName -Value $cred

Para criar um novo certificado do PowerShell com o Windows PowerShell no Service Management Automation

Os seguintes comandos de exemplo mostram como criar um novo certificado importando um arquivo de certificado.

$webServer = 'https://MyWebServer'
$port = 9090
$certName = 'MyCertificate'
$path = 'c:\certs\MyCertificate.pfx'
$certPwd = ConvertTo-SecureString -String 'P@$$w0rd' -AsPlainText -Force

Set-SmaCertificate -WebServiceEndpoint $webServer -port $port -Name $certName –Path $certPath –Password $certPwd

Usando uma credencial do PowerShell em um Runbook

Você recupera uma credencial do PowerShell em um runbook com a atividade Get-AutomationPSCredential. Isso retorna um objeto PSCredential que pode ser usado no fluxo de trabalho.

Para usar uma credencial do PowerShell em um runbook

Os comandos de exemplo a seguir mostram como usar uma credencial do PowerShell em um runbook. Neste exemplo, a credencial é usada com uma atividade InlineScript para executar um conjunto de comandos usando credenciais alternativas.
```
$myCredential = Get-AutomationPSCredential -Name 'MyCredential'
InlineScript {
   <Commands>
} -PSComputerName $ServerName -PSCredential $myCredential
```

Consulte também

Service Management Automation
Criação de runbooks de automação
Ativos globais

Compartilhar via