Set-SmaVariable
在 SMA 中建立或修改變量。
語法
Set-SmaVariable
-Name <String>
-Value <Object>
[-Description <String>]
[-Encrypted]
[-Force]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-SmaVariable Cmdlet 會在系統管理自動化 （SMA） 中建立或修改變量。 指定變數的名稱和值。
若要加密變數，請使用 Encrypted 參數。 您無法在建立之後修改變量的加密狀態。 如果您在現有的非加密變數上使用 Encrypted 參數，此 Cmdlet 將會失敗。
範例
範例 1：將值指派給變數
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted此命令會將 String07 值指派給指定 Web 服務端點之 Variable01 的變數。 因為命令會指定 Encrypted 參數，所以它會加密變數。
參數
-AuthenticationType
指定驗證類型。 有效值為：
- 基本
- 窗戶
此參數的預設值為 Windows。 如果您使用基本身份驗證，則必須使用 Credential 參數來提供認證。
| 類型: | String |
| 接受的值: | Basic, Windows |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Credential
指定 SMA Web 服務的連線 PSCredential 物件。
若要取得認證物件，請使用 Get-Credential Cmdlet。
如需詳細資訊，請輸入 Get-Help Get-Credential。
| 類型: | PSCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Description
提供變數的描述。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Encrypted
表示此 Cmdlet 會加密變數。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Force
修改變量，而不提示您進行確認。 如果您提供 SecureString 做為 Value 參數的值，Cmdlet 會提示您進行確認。 如果值包含 SecureString 做為欄位的物件，而且您不使用 Encrypted 參數，此 Cmdlet 也會提示您。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定變數的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Port
指定 SMA Web 服務的埠號碼。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Value
指定變數的值。
| 類型: | Object |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WebServiceEndpoint
將端點指定為 SMA Web 服務的 URL。 您必須包含通訊協定，例如 http:// 或 https://。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |