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 |