Partilhar via

New-SmaConnection

  • Referência
Módulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Cria uma instância de conexão no SMA.

Sintaxe

New-SmaConnection
   -Name <String>
   -ConnectionTypeName <String>
   [-ConnectionFieldValues <Hashtable>]
   [-Description <String>]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

O cmdlet New-SmaConnection cria uma instância de conexão no Service Management Automation (SMA).

Exemplos

Exemplo 1: Criar uma conexão

PS C:\> New-SmaConnection -WebServiceEndpoint "https://contoso.com/app01" -Name "MyConnection" -ConnectionTypeName "MyConnectionType" -Description "This is a new connection" -ConnectionFieldValues @{ "Hostname"="Computer01"; "Username"="PattiFuller"; Password="passw0rd!"}

Este comando cria uma conexão chamada MyConnection usando o Name, ConnectionTypeNamee parâmetros ConnectionFieldValues.

Atenção

A Microsoft recomenda que você use o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste exemplo requer um grau muito alto de confiança no aplicativo e acarreta riscos que não estão presentes em outros fluxos.

Parâmetros

-AuthenticationType

Especifica o tipo de autenticação. Os valores válidos são:

  • Básico
  • Mac OS

O valor padrão para esse parâmetro é Windows. Se você usar a autenticação Básica, deverá fornecer credenciais usando o parâmetro Credential.

Tipo:String
Valores aceites:Basic, Windows
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConnectionFieldValues

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

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConnectionTypeName

Especifica um tipo de conexão.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica um objeto PSCredential para a conexão com o serviço Web SMA. Para obter um objeto de credencial, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica um nome para a conexão.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Port

Especifica o número da porta do serviço Web SMA.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WebServiceEndpoint

Especifica o ponto de extremidade, como uma URL, do serviço Web SMA. Você deve incluir o protocolo, por exemplo, http:// ou https://.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False