Delen via


New-AzApiManagementNamedValue

Hiermee maakt u een nieuwe benoemde waarde.

Syntaxis

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

Description

Met de cmdlet New-AzApiManagementNamedValue wordt een Azure API Management Named Value gemaakt.

Voorbeelden

Voorbeeld 1: Een benoemde waarde maken die tags bevat

$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

Met de eerste opdracht worden twee waarden toegewezen aan de variabele $Tags. Met de tweede opdracht maakt u een benoemde waarde en wijst u de tekenreeksen in $Tags toe als tags op de eigenschap.

Voorbeeld 2: Een benoemde waarde met een geheime waarde maken

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

Met deze opdracht maakt u een benoemde waarde met een waarde die is versleuteld.

Voorbeeld 3: Een keyVault Namedvalue maken

$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

Met de eerste opdracht maakt u een sleutelkluis. Met de tweede opdracht maakt u een benoemde waarde met behulp van een geheim uit deze sleutelkluis.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Exemplaar van PsApiManagementContext. Deze parameter is vereist.

Type:PsApiManagementContext
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KeyVault

KeyVault gebruikt om Namedvalue-gegevens op te halen. Deze parameter is vereist als waarde niet is opgegeven. Zie New-AzApiManagementKeyVaultObject voor meer informatie.

Type:PsApiManagementKeyVaultEntity
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Naam van de benoemde waarde. De maximale lengte is 100 tekens. Het mag alleen letters, cijfers, punten, streepjes en onderstrepingstekens bevatten. Deze parameter is vereist.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NamedValueId

Id van nieuwe benoemde waarde. Deze parameter is optioneel. Als dit niet is opgegeven, wordt deze gegenereerd.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Secret

Bepaalt of de waarde een geheim is en of niet moet worden versleuteld. Deze parameter is optioneel. De standaardwaarde is onwaar.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Tag

Tags die moeten worden gekoppeld aan de benoemde waarde. Deze parameter is optioneel.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Value

Waarde van de benoemde waarde. Kan beleidsexpressies bevatten. De maximale lengte is 1000 tekens. Deze mag niet leeg zijn of bestaan alleen uit witruimte. Deze parameter is vereist.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PsApiManagementContext

String

SwitchParameter

String[]

Uitvoerwaarden

PsApiManagementNamedValue