Condividi tramite

New-AzApiManagementCertificate

  • Riferimento
Modulo:
Az.ApiManagement

Crea un certificato di Gestione API da usare durante l'autenticazione con back-end.

Sintassi

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

Descrizione

Il cmdlet New-AzApiManagementCertificate crea un certificato di Gestione API di Azure.

Esempio

Esempio 1: Creare e caricare un certificato

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

Questo comando carica un certificato in Gestione API. Questo certificato può essere usato per l'autenticazione reciproca con back-end tramite criteri.

Esempio 2

Crea un certificato di Gestione API da usare durante l'autenticazione con back-end. (generato automaticamente)

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

Esempio 3: Creare un certificato keyVault

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

Il primo comando crea un insieme di credenziali delle chiavi. Il secondo comando crea un certificato usando il segreto di questo insieme di credenziali delle chiavi.

Parametri

-CertificateId

Specifica l'ID del certificato da creare. Se non si specifica questo parametro, viene generato automaticamente un ID.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Context

Specifica un oggetto PsApiManagementContext .

Tipo:PsApiManagementContext
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-KeyVault

KeyVault usato per recuperare i dati del certificato. Questo parametro è obbligatorio se -PfxFilePath non specificato. Per informazioni dettagliate, vedere New-AzApiManagementKeyVaultObject.

Tipo:PsApiManagementKeyVaultEntity
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PfxBytes

Specifica una matrice di byte del file di certificato in formato pfx. Questo parametro è obbligatorio se non si specifica il parametro PfxFilePath.

Tipo:Byte[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PfxFilePath

Specifica il percorso del file di certificato in formato pfx da creare e caricare. Questo parametro è obbligatorio se non si specifica il parametro PfxBytes .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PfxPassword

Specifica la password per il certificato.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PsApiManagementContext

String

Byte[]

Output

PsApiManagementCertificate