New-AzApiManagementNamedValue

Reference

Modul:: Az.ApiManagement

Vytvoří novou pojmenovanou hodnotu.

Syntaxe

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

Description

Rutina New-AzApiManagementNamedValue vytvoří pojmenovanou hodnotu služby Azure API Management.

Příklady

Příklad 1: Vytvoření pojmenované hodnoty, která obsahuje značky

$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

První příkaz přiřadí $Tags proměnné dvě hodnoty. Druhý příkaz vytvoří pojmenovanou hodnotu a přiřadí řetězce v $Tags jako značky vlastnosti.

Příklad 2: Vytvoření pojmenované hodnoty s hodnotou tajného kódu

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

Tento příkaz vytvoří pojmenovanou hodnotu, která má zašifrovanou hodnotu.

Příklad 3: Vytvoření pojmenované hodnoty keyVault

$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

První příkaz vytvoří keyvault. Druhý příkaz vytvoří pojmenovanou hodnotu pomocí tajného kódu z tohoto klíče.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Context

Instance of PsApiManagementContext. Tento parametr je povinný.

Typ:	PsApiManagementContext
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-KeyVault

KeyVault slouží k načtení dat Pojmenované hodnoty. Tento parametr je povinný, pokud není zadána hodnota. Podrobnosti najdete v New-AzApiManagementKeyVaultObject.

Typ:	PsApiManagementKeyVaultEntity
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Název pojmenované hodnoty Maximální délka je 100 znaků. Může obsahovat pouze písmena, číslice, tečku, pomlčku a podtržítka. Tento parametr je povinný.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-NamedValueId

Identifikátor nové pojmenované hodnoty Tento parametr je volitelný. Pokud nezadáte, vygeneruje se.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Secret

Určuje, zda je hodnota tajný klíč a má být zašifrována, nebo ne. Tento parametr je volitelný. Výchozí hodnota je false.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Tag

Značky, které se mají přidružit k pojmenované hodnotě. Tento parametr je volitelný.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Value

Hodnota pojmenované hodnoty Může obsahovat výrazy zásad. Maximální délka je 1000 znaků. Nemusí být prázdný nebo se skládat pouze z prázdných znaků. Tento parametr je povinný.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

PsApiManagementContext

String

SwitchParameter

String[]

Výstupy

PsApiManagementNamedValue

Sdílet prostřednictvím