Partilhar via

New-AzApiManagementCertificate

  • Referência
Módulo:
Az.ApiManagement

Cria um certificado de Gerenciamento de API para ser usado durante a Autenticação com Back-end.

Sintaxe

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

O cmdlet New-AzApiManagementCertificate cria um certificado de Gerenciamento de API do Azure.

Exemplos

Exemplo 1: Criar e carregar um certificado

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

Este comando carrega um certificado para o Gerenciamento de API. Esse certificado pode ser usado para autenticação mútua com back-end usando políticas.

Exemplo 2

Cria um certificado de Gerenciamento de API para ser usado durante a Autenticação com Back-end. (gerado automaticamente)

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

Exemplo 3: Criar um certificado keyVault

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

O primeiro comando cria um keyvault. O segundo comando cria um certificado usando secret deste keyvault.

Parâmetros

-CertificateId

Especifica a ID do certificado a ser criado. Se você não especificar esse parâmetro, um ID será gerado para você.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Context

Especifica um objeto PsApiManagementContext .

Tipo:PsApiManagementContext
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyVault

KeyVault usado para buscar dados de certificado. Este parâmetro é necessário se -PfxFilePath não for especificado. Consulte New-AzApiManagementKeyVaultObject para obter detalhes.

Tipo:PsApiManagementKeyVaultEntity
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PfxBytes

Especifica uma matriz de bytes do arquivo de certificado no formato .pfx. Este parâmetro é necessário se você não especificar o parâmetro PfxFilePath .

Tipo:Byte[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PfxFilePath

Especifica o caminho para o arquivo de certificado no formato .pfx a ser criado e carregado. Este parâmetro é necessário se você não especificar o parâmetro PfxBytes .

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PfxPassword

Especifica a senha para o certificado.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

PsApiManagementContext

String

Byte[]

Saídas

PsApiManagementCertificate