Set-SmaVariable

Set-SmaVariable

Creates or modifies a variable in .

構文

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

詳細説明

The Set-SmaVariable cmdlet creates or modifies a variable in . Specify the name of the variable and a value.

To encrypt the variable, use the Encrypted parameter. You cannot modify the encrypted state of a variable after creation. Using the Encrypted parameter on an existing, non-encrypted, variable fails.

パラメーター

-AuthenticationType<String>

Specifies the authentication type. Valid values are: Basic, Windows.

Windows is the default value. If you use Basic authentication, you must provide credentials by using the Credential parameter.

-Credential<PSCredential>

Specifies user credentials, as a PSCredential object, to use for the connection to the web service. To obtain a credential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.

-Description<String>

Provides a description for the variable.

-Encrypted

Indicates that the variable should be encrypted.

-Force

Modifies the variable without prompting you for confirmation. The cmdlet prompts you for confirmation before it proceeds if you provide a SecureString as the value for the Value parameter, or if the value contains an object with SecureString as a field and you do not use the Encrypted parameter.

-Name<String>

Specifies the name of a variable.

-Port<Int32>

Specifies the port number of the web service.

-Value<Object>

Specifies a value for the variable.

-WebServiceEndpoint<String>

Specifies the endpoint, as a URL, of the web service. Include the protocol, for example, http:// or https://.

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Assign a value to a variable

This command assigns the value String07 to the variable named Variable01 for the specified web service endpoint. Because the command specifies the Encrypted parameter, it encrypts the variable.

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

関連トピック

Get-SmaVariable

Remove-SmaVariable