Compartir a través de


Set-SmaVariable

Crea o modifica una variable en SMA.

Syntax

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 no cifrada existente.

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 .

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Proporciona una descripción de la variable.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Encrypted

Indica que este cmdlet cifra la variable.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica el nombre de una variable.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Port

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Especifica un valor para la variable.

Type:Object
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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://.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False