Dela via


Set-AzApiManagementNamedValue

Ändrar ett API Management-namngivet värde.

Syntax

Set-AzApiManagementNamedValue
   -Context <PsApiManagementContext>
   -NamedValueId <String>
   [-Name <String>]
   [-Value <String>]
   [-Secret <Boolean>]
   [-Tag <String[]>]
   [-PassThru]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten Set-AzApiManagementNamedValue ändrar ett Azure API Management-namngivet värde.

Exempel

Exempel 1: Ändra taggarna för det namngivna värdet

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
$Tags = 'sdk', 'powershell'
Set-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property11" -Tag $Tags -PassThru

Det första kommandot tilldelar två värden till variabeln $Tags. Det andra kommandot ändrar det namngivna värdet som har ID-egenskapen 11. Kommandot tilldelar strängarna i $Tags som taggar på det namngivna värdet.

Exempel 2: Ändra det namngivna värdet så att det har ett hemligt värde

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Secret $True -PassThru

Det här kommandot ändrar det namngivna värdet så att det krypteras.

Exempel 3

Ändrar ett API Management-namngivet värde. (automatiskt genererad)

Set-AzApiManagementNamedValue -Context <PsApiManagementContext> -Name 'ContosoApi' -NamedValueId 'Property11' -Secret $true -Tag <String[]> -Value 'Property Value'

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

Instans av PsApiManagementContext. Den här parametern krävs.

Typ:PsApiManagementContext
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på det namngivna värdet. Maximal längd är 100 tecken. Den får endast innehålla bokstäver, siffror, punkttecken, bindestreck och understreck. Den här parametern är valfri.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NamedValueId

Identifierare för namngivet värde som ska uppdateras. Den här parametern är obligatorisk.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Om det anges skrivs instansen av typen Microsoft.Azure.Commands.ApiManagement.ServiceManagement.Models.PsApiManagementProperty som representerar den ändrade egenskapen till utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Secret

Om det namngivna värdet är en hemlighet och dess värde ska krypteras. Den här parametern är valfri.

Typ:Nullable<T>[Boolean]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Tag

Taggar som är associerade med det namngivna värdet. Den här parametern är valfri.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Value

Värdet för det namngivna värdet. Kan innehålla principuttryck. Maximal längd är 1 000 tecken. Den kanske inte är tom eller bara består av blanksteg. Den här parametern är valfri.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PsApiManagementContext

String

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String[]

SwitchParameter

Utdata

PsApiManagementNamedValue