Delen via

New-AzApiManagementCertificate

  • Referentie
Module:
Az.ApiManagement

Hiermee maakt u een API Management-certificaat dat moet worden gebruikt tijdens verificatie met back-end.

Syntaxis

New-AzApiManagementCertificate
   -Context <PsApiManagementContext>
   [-CertificateId <String>]
   [-PfxFilePath <String>]
   [-PfxPassword <String>]
   [-KeyVault <PsApiManagementKeyVaultEntity>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzApiManagementCertificate
   -Context <PsApiManagementContext>
   [-CertificateId <String>]
   [-PfxBytes <Byte[]>]
   [-PfxPassword <String>]
   [-KeyVault <PsApiManagementKeyVaultEntity>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

De cmdlet New-AzApiManagementCertificate maakt een Azure API Management-certificaat.

Voorbeelden

Voorbeeld 1: Een certificaat maken en uploaden

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementCertificate -Context $ApiMgmtContext -PfxFilePath "C:\contoso\certificates\apimanagement.pfx" -PfxPassword "1111"

Met deze opdracht wordt een certificaat geüpload naar Api Management. Dit certificaat kan worden gebruikt voor wederzijdse verificatie met back-end met behulp van beleid.

Voorbeeld 2

Hiermee maakt u een API Management-certificaat dat moet worden gebruikt tijdens verificatie met back-end. (automatisch gegenereerd)

New-AzApiManagementCertificate -CertificateId '0123456789' -Context <PsApiManagementContext> -PfxFilePath 'C:\contoso\certificates\apimanagement.pfx' -PfxPassword '1111'

Voorbeeld 3: Een keyVault-certificaat maken

$secretIdentifier = 'https://contoso.vault.azure.net/secrets/xxxx'
$keyvault = New-AzApiManagementKeyVaultObject -SecretIdentifier $secretIdentifier
$keyVaultcert = New-AzApiManagementCertificate -Context $context -CertificateId $kvcertId -KeyVault $keyvault

Met de eerste opdracht maakt u een sleutelkluis. Met de tweede opdracht maakt u een certificaat met een geheim van deze sleutelkluis.

Parameters

-CertificateId

Hiermee geeft u de id van het certificaat dat moet worden gemaakt. Als u deze parameter niet opgeeft, wordt er een id voor u gegenereerd.

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

-Context

Hiermee geeft u een PsApiManagementContext-object .

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement 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 die wordt gebruikt om certificaatgegevens op te halen. Deze parameter is vereist als -PfxFilePath niet is opgegeven. Zie New-AzApiManagementKeyVaultObject voor meer informatie.

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

-PfxBytes

Hiermee geeft u een matrix van bytes van het certificaatbestand in PFX-indeling. Deze parameter is vereist als u de pfxFilePath-parameter niet opgeeft.

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

-PfxFilePath

Hiermee geeft u het pad naar het certificaatbestand in PFX-indeling op om te maken en te uploaden. Deze parameter is vereist als u de parameter PfxBytes niet opgeeft.

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

-PfxPassword

Hiermee geeft u het wachtwoord voor het certificaat.

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

Invoerwaarden

PsApiManagementContext

String

Byte[]

Uitvoerwaarden

PsApiManagementCertificate