Condividi tramite

New-AzApiManagementCertificate

  • Riferimento
Modulo:
Az.ApiManagement

Crea un certificato 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 Azure Gestione API.

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

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

-Context

Specifica un oggetto PsApiManagementContext .

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

-DefaultProfile

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

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

-KeyVault

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

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

-PfxBytes

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

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 .

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

-PfxPassword

Specifica la password per il certificato.

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

Input

PsApiManagementContext

String

Byte[]

Output

PsApiManagementCertificate