Set-SmaVariable

  • Referencia
Módulo:
Microsoft.SystemCenter.ServiceManagementAutomation

Crea o modifica una variable en SMA.

Sintaxis

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

Description

El cmdlet set-SmaVariable crea o modifica una variable en System Management Automation (SMA). Especifique el nombre de la variable y un valor.

Para cifrar la variable, use el parámetro Encrypted. No se puede modificar el estado cifrado de una variable después de la creación. Este cmdlet producirá un error si usa el parámetro Encrypted en una variable existente no cifrada.

Ejemplos

Ejemplo 1: Asignación de un valor a una variable

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

Este comando asigna el valor String07 a la variable denominada Variable01 para el punto de conexión de servicio web especificado. Dado que el comando especifica el parámetro Encrypted, cifra la variable.

Parámetros

-AuthenticationType

Especifica el tipo de autenticación. Los valores válidos son:

  • Básico
  • Windows

El valor predeterminado de este parámetro es Windows. Si usa la autenticación básica, debe proporcionar credenciales mediante el parámetro credential .

Tipo:String
Valores aceptados:Basic, Windows
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica un objeto PSCredential para la conexión al servicio web SMA. Para obtener un objeto de credencial, use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help Get-Credential.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Proporciona una descripción de la variable.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Encrypted

Indica que este cmdlet cifra la variable.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Modifica la variable sin pedir confirmación. El cmdlet le pide confirmación antes de continuar si proporciona secureString como valor para el parámetro Value. Este cmdlet también le pregunta si el valor contiene un objeto con SecureString como campo y no usa el parámetro Encrypted.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de una variable.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Port

Especifica el número de puerto del servicio web SMA.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Value

Especifica un valor para la variable.

Tipo:Object
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WebServiceEndpoint

Especifica el punto de conexión, como una dirección URL, del servicio web SMA. Debe incluir el protocolo, por ejemplo, http:// o https://.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False