O cmdlet New-SmaConnection cria uma instância de conexão no SMA (Service Management Automation).
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!"}
Esse comando cria uma conexão chamada MyConnection usando os parâmetros Name, ConnectionTypeName e ConnectionFieldValues .
Cuidado
A Microsoft recomenda usar 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 traz 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
Windows
O valor padrão para esse parâmetro é Windows.
Se você usar a autenticação Básica, deverá fornecer credenciais usando o parâmetro credencial.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Valores aceitos:
Basic, Windows
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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.
Propriedades do parâmetro
Tipo:
Hashtable
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-ConnectionTypeName
Especifica um tipo de conexão.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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.
Propriedades do parâmetro
Tipo:
PSCredential
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Description
Especifica uma descrição para a conexão.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Name
Especifica um nome para a conexão.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
-Port
Especifica o número da porta do serviço Web SMA.
Propriedades do parâmetro
Tipo:
Int32
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
False
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
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://.
Propriedades do parâmetro
Tipo:
String
Valor padrão:
None
Dá suporte a curingas:
False
DontShow:
False
Conjuntos de parâmetros
(All)
Cargo:
Named
Obrigatório:
True
Valor do pipeline:
False
Valor do pipeline pelo nome da propriedade:
False
Valor dos argumentos restantes:
False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.