New-AzApiManagementNamedValue

Başvuru

Modül:: Az.ApiManagement

Yeni Adlandırılmış Değer oluşturur.

Sözdizimi

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

Description

New-AzApiManagementNamedValue cmdlet'i Value adlı bir Azure API Management oluşturur.

Örnekler

Örnek 1: Etiketleri içeren adlandırılmış bir değer oluşturma

$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

İlk komut, $Tags değişkenine iki değer atar. İkinci komut adlandırılmış bir değer oluşturur ve $Tags içindeki dizeleri özelliğinde etiket olarak atar.

Örnek 2: Gizli dizi değerine sahip adlandırılmış bir değer oluşturma

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

Bu komut, şifrelenmiş bir değere sahip bir Adlandırılmış Değer oluşturur.

Örnek 3 : KeyVault Namedvalue oluşturma

$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

İlk komut bir keyvault oluşturur. İkinci komut, bu keyvault'tan gizli dizi kullanarak adlandırılmış bir değer oluşturur.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Context

PsApiManagementContext örneği. Bu parametre zorunludur.

Tür:	PsApiManagementContext
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:	IAzureContextContainer
Diğer adlar:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-KeyVault

KeyVault, Namedvalue verilerini getirmek için kullanılır. Değer belirtilmezse bu parametre gereklidir. Ayrıntılar için bkz. New-AzApiManagementKeyVaultObject.

Tür:	PsApiManagementKeyVaultEntity
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

Adlandırılmış değerin adı. Uzunluk üst sınırı 100 karakterdir. Yalnızca harf, rakam, nokta, tire ve alt çizgi karakterleri içerebilir. Bu parametre zorunludur.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-NamedValueId

Yeni adlandırılmış değerin tanımlayıcısı. Bu parametre isteğe bağlıdır. Belirtilmezse oluşturulur.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Secret

Değerin gizli dizi olup olmadığını ve şifrelenip şifrelenmemesi gerektiğini belirler. Bu parametre isteğe bağlıdır. Varsayılan Değer false'tur.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Tag

Adlandırılmış değerle ilişkilendirilecek etiketler. Bu parametre isteğe bağlıdır.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Value

Adlandırılmış değerin değeri. İlke ifadeleri içerebilir. Uzunluk üst sınırı 1000 karakterdir. Boş olmayabilir veya yalnızca boşluklardan oluşabilir. Bu parametre zorunludur.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False