Set-AzApiManagementNamedValue
修改 API 管理 具名值。
語法
Set-AzApiManagementNamedValue
-Context <PsApiManagementContext>
-NamedValueId <String>
[-Name <String>]
[-Value <String>]
[-Secret <Boolean>]
[-Tag <String[]>]
[-PassThru]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzApiManagementNamedValue Cmdlet 會修改 Azure API 管理 具名值。
範例
範例 1:變更具名值上的標記
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
$Tags = 'sdk', 'powershell'
Set-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property11" -Tag $Tags -PassThru
第一個命令會將兩個值指派給 $Tags 變數。 第二個命令會修改具有ID Property11的具名值。 命令會將 $Tags 中的字串指派為具名值上的標記。
範例 2:將具名值修改為具有秘密值
$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Secret $True -PassThru
此命令會將具名值變更為 Encrypted。
範例 3
修改 API 管理 具名值。 ( 自動產生 )
Set-AzApiManagementNamedValue -Context <PsApiManagementContext> -Name 'ContosoApi' -NamedValueId 'Property11' -Secret $true -Tag <String[]> -Value 'Property Value'
參數
-Confirm
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Context
PsApiManagementContext 的實例。 此為必要參數。
類型: | PsApiManagementContext |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Name
具名值的名稱。 長度上限是 100 個字元。 它只能包含字母、數位、句點、虛線和底線字元。 這是選擇性參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-NamedValueId
要更新之具名值的標識碼。 這是必要參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PassThru
如果指定,則會將代表修改屬性的 Microsoft.Azure.Commands.ApiManagement.ServiceManagement.Models.PsApiManagementProperty 類型的實例寫入輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Secret
具名值是否為秘密,且其值是否應加密。 這是選擇性參數。
類型: | Nullable<T>[Boolean] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Tag
與具名值相關聯的標記。 這是選擇性參數。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Value
具名值的值。 可以包含原則表達式。 長度上限是 1000 個字元。 它不可以是空的,或只包含空格符。 這是選擇性參數。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
String[]