Partilhar via

Set-SmaVariable

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

Cria ou modifica uma variável no SMA.

Sintaxe

Set-SmaVariable
   -Name <String>
   -Value <Object>
   [-Description <String>]
   [-Encrypted]
   [-Force]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-SmaVariable cria ou modifica uma variável no System Management Automation (SMA). Especifique o nome da variável e um valor.

Para criptografar a variável, use o parâmetro Encrypted. Não é possível modificar o estado criptografado de uma variável após a criação. Esse cmdlet falhará se você usar o parâmetro Encrypted em uma variável existente não criptografada.

Exemplos

Exemplo 1: Atribuir um valor a uma variável

PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted

Este comando atribui o valor String07 à variável chamada Variable01 para o ponto de extremidade do serviço Web especificado. Como o comando especifica o parâmetro Encrypted, ele criptografa a variável.

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

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
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

Fornece uma descrição para a variável.

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

-Encrypted

Indica que esse cmdlet criptografa a variável.

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

-Force

Modifica a variável sem solicitar a confirmação. O cmdlet solicitará a confirmação antes de prosseguir se você fornecer um SecureString como o valor para o parâmetro Value. Este cmdlet também perguntará se o valor contém um objeto com SecureString como um campo e você não usa o parâmetro Encrypted.

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

-Name

Especifica o nome de uma variável.

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

-Value

Especifica um valor para a variável.

Tipo:Object
Position:Named
Default value:None
Necessário:True
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

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False