New-AzApiManagementNamedValue

Riferimento

Modulo:: Az.ApiManagement

Crea un nuovo valore denominato.

Sintassi

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

Descrizione

Il cmdlet New-AzApiManagementNamedValue crea un valore denominato di Azure Gestione API.

Esempio

Esempio 1: Creare un valore denominato che include tag

$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

Il primo comando assegna due valori alla variabile $Tags. Il secondo comando crea un valore denominato e assegna le stringhe in $Tags come tag nella proprietà .

Esempio 2: Creare un valore denominato con un valore segreto

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

Questo comando crea un valore denominato con un valore crittografato.

Esempio 3: Creare un 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

Il primo comando crea un insieme di credenziali delle chiavi. Il secondo comando crea un valore denominato usando il segreto di questo insieme di credenziali delle chiavi.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Istanza di PsApiManagementContext. Questo parametro è obbligatorio.

Type:	PsApiManagementContext
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVault

KeyVault usato per recuperare i dati Namedvalue. Questo parametro è obbligatorio se Value non è specificato. Per informazioni dettagliate, vedere New-AzApiManagementKeyVaultObject.

Type:	PsApiManagementKeyVaultEntity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nome del valore denominato. La lunghezza massima consentita è di 100 caratteri. Può contenere solo lettere, cifre, punti, trattini e caratteri di sottolineatura. Questo parametro è obbligatorio.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-NamedValueId

Identificatore del nuovo valore denominato. Il parametro è facoltativo. Se non specificato, verrà generato.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Secret

Determina se il valore è un segreto e se deve essere crittografato. Il parametro è facoltativo. Il valore predefinito è false.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Tag da associare al valore denominato. Il parametro è facoltativo.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

Valore del valore denominato. Può contenere espressioni di criteri. La lunghezza massima consentita è di 1000 caratteri. Non può essere vuoto o contenere solo spazi. Questo parametro è obbligatorio.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

PsApiManagementContext

String

SwitchParameter

String[]

Output

PsApiManagementNamedValue

Condividi tramite