Compartilhar via


Set-SmaConnectionFieldValue

Modifica um valor de campo de conexão para um objeto de conexão no SMA.

Sintaxe

Set-SmaConnectionFieldValue
   -ConnectionName <String>
   -ConnectionFieldName <String>
   -Value <Object>
   [-Force]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-SmaConnectionFieldValue modifica um valor de campo de conexão para um objeto de conexão no SMA (Service Management Automation).

Exemplos

Exemplo 1: modificar um valor de campo de conexão

PS C:\> $Password = ConvertTo-SecureString -String "PassWord01!" -Force
PS C:\> Set-SmaConnectionFieldValue -WebServiceEndpoint "https://contoso.com/app01" -ConnectionName "MyConnection" -ConnectionFieldName "Password" -Value $Password

O primeiro comando converte a cadeia de caracteres fornecida em uma cadeia de caracteres segura e armazena o objeto SecureString na variável $Password.

O segundo comando modifica o valor do campo de conexão chamado Senha.

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.

Tipo:String
Valores aceitos:Basic, Windows
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConnectionFieldName

Especifica o nome de um campo de conexão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConnectionName

Especifica o nome de uma conexão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Port

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Value

Especifica um valor para o campo de conexão.

Tipo:Object
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False