New-AzApiManagementNamedValue

Referens

Modul:: Az.ApiManagement

Skapar nytt namngivet värde.

Syntax

New-AzApiManagementNamedValue
   -Context <PsApiManagementContext>
   [-NamedValueId <String>]
   [-Name <String>]
   [-Value <String>]
   [-Secret]
   [-Tag <String[]>]
   [-KeyVault <PsApiManagementKeyVaultEntity>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-AzApiManagementNamedValue skapar en Azure API Management-med namnet Value.

Exempel

Exempel 1: Skapa ett namngivet värde som innehåller taggar

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

Det första kommandot tilldelar två värden till variabeln $Tags. Det andra kommandot skapar ett namngivet värde och tilldelar strängarna i $Tags som taggar på egenskapen.

Exempel 2: Skapa ett namngivet värde som har ett hemligt värde

$apimContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementNamedValue -Context $apimContext -NamedValueId "Property12" -Name "Secret Property" -Value "Secret Property Value" -Secret

Det här kommandot skapar ett namngivet värde som har ett krypterat värde.

Exempel 3: Skapa en keyVault Namedvalue

$secretIdentifier = 'https://contoso.vault.azure.net/secrets/xxxx'
$keyvault = New-AzApiManagementKeyVaultObject -SecretIdentifier $secretIdentifier 
$keyVaultNamedValue = New-AzApiManagementNamedValue -Context $context -NamedValueId $keyVaultNamedValueId -Name $keyVaultNamedValueName -keyVault $keyvault -Secret

Det första kommandot skapar en keyvault. Det andra kommandot skapar ett namngivet värde med hjälp av hemligheten från den här nyckelvalvet.

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

-KeyVault

KeyVault används för att hämta Namedvalue-data. Den här parametern krävs om värdet inte har angetts. Mer information finns i New-AzApiManagementKeyVaultObject.

Typ:	PsApiManagementKeyVaultEntity
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
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 krävs.

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

-NamedValueId

Identifierare för nytt namngivet värde. Den här parametern är valfri. Om det inte anges genereras.

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

-Secret

Avgör om värdet är en hemlighet och ska krypteras eller inte. Den här parametern är valfri. Standardvärdet är falskt.

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

-Tag

Taggar som ska associeras med namngivet värde. 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 krävs.

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 cmdleten 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

SwitchParameter

String[]

Utdata

PsApiManagementNamedValue

Dela via