Set-SmaVariable
Crée ou modifie une variable dans SMA.
Syntax
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 crée ou modifie une variable dans System Management Automation (SMA). Spécifiez le nom de la variable et une valeur.
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 non chiffrée existante.
Exemples
Exemple 1 : Affecter une valeur à une variable
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted
Cette 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 Encrypted , elle chiffre la variable.
Paramètres
-AuthenticationType
Spécifie le type d’authentification. Les valeurs autorisées sont :
- De base
- 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 |
Accepted values: | Basic, Windows |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, voir Get-Help Get-Credential
.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Fournit une description de la variable.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypted
Indique que cette applet de commande chiffre la variable.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Modifie la variable sans vous inviter à confirmer. L’applet de commande vous invite à confirmer avant de procéder 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifie le nom d'une variable.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Spécifie le numéro de port du service web SMA.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Spécifie une valeur pour la variable.
Type: | Object |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |