New-AzApiManagementCertificate

  • Referenz
Modul:
Az.ApiManagement

Erstellt ein API-Verwaltungszertifikat, das während der Authentifizierung mit Back-End verwendet werden soll.

Syntax

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>]

Beschreibung

Das Cmdlet New-AzApiManagementCertificate erstellt ein Azure API Management-Zertifikat.

Beispiele

Beispiel 1: Erstellen und Hochladen eines Zertifikats

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

Mit diesem Befehl wird ein Zertifikat in die API-Verwaltung hochgeladen. Dieses Zertifikat kann für die gegenseitige Authentifizierung mit Back-End-Richtlinien verwendet werden.

Beispiel 2

Erstellt ein API-Verwaltungszertifikat, das während der Authentifizierung mit Back-End verwendet werden soll. (automatisch generiert)

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

Beispiel 3: Erstellen eines keyVault-Zertifikats

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

Der erste Befehl erstellt einen Keyvault. Der zweite Befehl erstellt ein Zertifikat mithilfe eines geheimen Schlüssels aus diesem Keyvault.

Parameter

-CertificateId

Gibt die ID des zu erstellenden Zertifikats an. Wenn Sie diesen Parameter nicht angeben, wird eine ID für Sie generiert.

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

-Context

Gibt ein PsApiManagementContext -Objekt an.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-KeyVault

KeyVault zum Abrufen von Zertifikatdaten. Dieser Parameter ist erforderlich, wenn -PfxFilePath nicht angegeben wurde. Details finden Sie unter New-AzApiManagementKeyVaultObject.

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

-PfxBytes

Gibt ein Array von Bytes der Zertifikatdatei im PFX-Format an. Dieser Parameter ist erforderlich, wenn Sie den PfxFilePath-Parameter nicht angeben.

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

-PfxFilePath

Gibt den Pfad zur Zertifikatdatei im PFX-Format an, das erstellt und hochgeladen werden soll. Dieser Parameter ist erforderlich, wenn Sie den Parameter PfxBytes nicht angeben.

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

-PfxPassword

Gibt das Kennwort für das Zertifikat an.

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

Eingaben

PsApiManagementContext

String

Byte[]

Ausgaben

PsApiManagementCertificate