Compartir a través de

New-AzApiManagementCertificate

  • Referencia
Módulo:
Az.ApiManagement

Crea un certificado de API Management que se usará durante la autenticación con back-end.

Sintaxis

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

El cmdlet New-AzApiManagementCertificate crea un certificado de Azure API Management.

Ejemplos

Ejemplo 1: Creación y carga de un certificado

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

Este comando carga un certificado en Api Management. Este certificado se puede usar para la autenticación mutua con back-end mediante directivas.

Ejemplo 2

Crea un certificado de API Management que se usará durante la autenticación con back-end. (generado automáticamente)

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

Ejemplo 3: Creación de un certificado keyVault

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

El primer comando crea un almacén de claves. El segundo comando crea un certificado mediante el secreto de este almacén de claves.

Parámetros

-CertificateId

Especifica el identificador del certificado que se va a crear. Si no especifica este parámetro, se genera un identificador automáticamente.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Context

Especifica un objeto PsApiManagementContext .

Tipo:PsApiManagementContext
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KeyVault

KeyVault se usa para capturar datos de certificado. Este parámetro es necesario si no se ha especificado -PfxFilePath. Consulte New-AzApiManagementKeyVaultObject para obtener más información.

Tipo:PsApiManagementKeyVaultEntity
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PfxBytes

Especifica una matriz de bytes del archivo de certificado en formato .pfx. Este parámetro es necesario si no especifica el parámetro PfxFilePath .

Tipo:Byte[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PfxFilePath

Especifica la ruta de acceso al archivo de certificado en formato .pfx para crear y cargar. Este parámetro es necesario si no especifica el parámetro PfxBytes .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PfxPassword

Especifica la contraseña del certificado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

PsApiManagementContext

String

Byte[]

Salidas

PsApiManagementCertificate