Dela via

New-AzApiManagementCertificate

  • Referens
Modul:
Az.ApiManagement

Skapar ett API Management-certifikat som ska användas under autentisering med serverdelen.

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

Description

Cmdleten New-AzApiManagementCertificate skapar ett Azure API Management-certifikat.

Exempel

Exempel 1: Skapa och ladda upp ett certifikat

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

Det här kommandot överför ett certifikat till Api Management. Det här certifikatet kan användas för ömsesidig autentisering med serverdelen med hjälp av principer.

Exempel 2

Skapar ett API Management-certifikat som ska användas under autentisering med serverdelen. (automatiskt genererad)

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

Exempel 3: Skapa ett keyVault-certifikat

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

Det första kommandot skapar en keyvault. Det andra kommandot skapar ett certifikat med hjälp av hemligheten från den här nyckelvalvet.

Parametrar

-CertificateId

Anger ID för certifikatet som ska skapas. Om du inte anger den här parametern genereras ett ID åt dig.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Context

Anger ett PsApiManagementContext- objekt.

Typ:PsApiManagementContext
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-KeyVault

KeyVault används för att hämta certifikatdata. Den här parametern krävs om -PfxFilePath inte anges. Mer information finns i New-AzApiManagementKeyVaultObject.

Typ:PsApiManagementKeyVaultEntity
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PfxBytes

Anger en matris med byte av certifikatfilen i .pfx-format. Den här parametern krävs om du inte anger parametern PfxFilePath.

Typ:Byte[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PfxFilePath

Anger sökvägen till certifikatfilen i pfx-format för att skapa och ladda upp. Den här parametern krävs om du inte anger parametern PfxBytes.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PfxPassword

Anger lösenordet för certifikatet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

PsApiManagementContext

String

Byte[]

Utdata

PsApiManagementCertificate