Partager via

New-AzApiManagementCertificate

  • Référence
Module:
Az.ApiManagement

Crée un certificat Gestion des API à utiliser pendant l’authentification avec le serveur principal.

Syntaxe

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

La cmdlet New-AzApiManagementCertificate crée un certificat Gestion des API Azure.

Exemples

Exemple 1 : Créer et charger un certificat

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

Cette commande charge un certificat dans Gestion des API. Ce certificat peut être utilisé pour l’authentification mutuelle avec le serveur principal à l’aide de stratégies.

Exemple 2

Crée un certificat Gestion des API à utiliser pendant l’authentification avec le serveur principal. (généré automatiquement)

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

Exemple 3 : Créer un certificat keyVault

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

La première commande crée un coffre de clés. La deuxième commande crée un certificat à l’aide du secret à partir de ce coffre de clés.

Paramètres

-CertificateId

Spécifie l’ID du certificat à créer. Si vous ne spécifiez pas ce paramètre, un ID est généré pour vous.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Context

Spécifie un objet PsApiManagementContext.

Type:PsApiManagementContext
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyVault

KeyVault utilisé pour extraire des données de certificat. Ce paramètre est obligatoire si -PfxFilePath non spécifié. Pour plus d’informations, consultez New-AzApiManagementKeyVaultObject.

Type:PsApiManagementKeyVaultEntity
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PfxBytes

Spécifie un tableau d’octets du fichier de certificat au format .pfx. Ce paramètre est obligatoire si vous ne spécifiez pas le paramètre PfxFilePath.

Type:Byte[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PfxFilePath

Spécifie le chemin d’accès au fichier de certificat au format .pfx pour créer et charger. Ce paramètre est obligatoire si vous ne spécifiez pas le paramètre pfxBytes .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PfxPassword

Spécifie le mot de passe du certificat.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

PsApiManagementContext

String

Byte[]

Sorties

PsApiManagementCertificate