Compartilhar via

New-AzApiManagementCertificate

  • Referência
Módulo:
Az.ApiManagement

Cria um certificado de Gerenciamento de API a 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"

Esse comando carrega um certificado no 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 a 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 o segredo desse keyvault.

Parâmetros

-CertificateId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Context

Especifica um objeto PsApiManagementContext .

Tipo:PsApiManagementContext
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KeyVault

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

Tipo:PsApiManagementKeyVaultEntity
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PfxBytes

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

Tipo:Byte[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PfxFilePath

Especifica o caminho para o arquivo de certificado no formato .pfx para criar e carregar. Esse parâmetro será necessário se você não especificar o parâmetro PfxBytes.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PfxPassword

Especifica a senha do certificado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PsApiManagementContext

String

Byte[]

Saídas

PsApiManagementCertificate