New-AzApiManagementNamedValue

Module:

Az.ApiManagement

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