Set-SmaVariable
Crée ou modifie une variable dans SMA.
Syntaxe
Set-SmaVariable
-Name <String>
-Value <Object>
[-Description <String>]
[-Encrypted]
[-Force]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande set-SmaVariable
Pour chiffrer la variable, utilisez le paramètre Encrypted. Vous ne pouvez pas modifier l’état chiffré d’une variable après la création. Cette applet de commande échoue si vous utilisez le paramètre Encrypted sur une variable existante non chiffrée.
Exemples
Exemple 1 : Affecter une valeur à une variable
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -EncryptedCette commande affecte la valeur String07 à la variable nommée Variable01 pour le point de terminaison de service web spécifié.
Étant donné que la commande spécifie le paramètre chiffré
Paramètres
-AuthenticationType
Spécifie le type d’authentification. Les valeurs valides sont les suivantes :
- Basique
- Windows
La valeur par défaut de ce paramètre est Windows. Si vous utilisez l’authentification de base, vous devez fournir des informations d’identification à l’aide du paramètre Credential.
| Type: | String |
| Valeurs acceptées: | Basic, Windows |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Credential
Spécifie un objet PSCredential pour la connexion au service web SMA.
Pour obtenir un objet d’informations d’identification, utilisez l’applet de commande Get-Credential.
Pour plus d’informations, tapez Get-Help Get-Credential.
| Type: | PSCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Fournit une description de la variable.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Encrypted
Indique que cette applet de commande chiffre la variable.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Force
Modifie la variable sans vous inviter à confirmer. L’applet de commande vous invite à confirmer avant de continuer si vous fournissez un SecureString comme valeur pour le paramètre Value. Cette applet de commande vous invite également si la valeur contient un objet avec SecureString en tant que champ et que vous n’utilisez pas le paramètre Encrypted.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Spécifie le nom d’une variable.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Port
Spécifie le numéro de port du service web SMA.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Value
Spécifie une valeur pour la variable.
| Type: | Object |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WebServiceEndpoint
Spécifie le point de terminaison, en tant qu’URL, du service web SMA. Vous devez inclure le protocole, par exemple, http:// ou https://.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | False |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |