Share via

New-AzApiManagementCertificate

  • Referencia
Módulo:
Az.ApiManagement

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

Syntax

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.

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

-Context

Especifica un objeto PsApiManagementContext .

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación 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 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.

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

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

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

-PfxPassword

Especifica la contraseña del certificado.

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

Entradas

PsApiManagementContext

String

Byte[]

Salidas

PsApiManagementCertificate