Sdílet prostřednictvím

New-AzApiManagementCertificate

  • Reference
Modul:
Az.ApiManagement

Vytvoří certifikát služby API Management, který se použije při ověřování s back-endem.

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

Rutina New-AzApiManagementCertificate vytvoří certifikát služby Azure API Management.

Příklady

Příklad 1: Vytvoření a nahrání certifikátu

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

Tento příkaz nahraje certifikát do služby Api Management. Tento certifikát lze použít pro vzájemné ověřování s back-endem pomocí zásad.

Příklad 2

Vytvoří certifikát služby API Management, který se použije při ověřování s back-endem. (automaticky vygenerováno)

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

Příklad 3: Vytvoření certifikátu služby KeyVault

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

První příkaz vytvoří keyvault. Druhý příkaz vytvoří certifikát pomocí tajného klíče z tohoto klíče.

Parametry

-CertificateId

Určuje ID certifikátu, který se má vytvořit. Pokud tento parametr nezadáte, vygeneruje se za vás ID.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Context

Určuje PsApiManagementContext objektu.

Typ:PsApiManagementContext
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyVault

KeyVault slouží k načtení dat certifikátu. Tento parametr se vyžaduje, pokud není zadán -PfxFilePath. Podrobnosti najdete v New-AzApiManagementKeyVaultObject.

Typ:PsApiManagementKeyVaultEntity
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PfxBytes

Určuje pole bajtů souboru certifikátu ve formátu .pfx. Tento parametr je povinný, pokud nezadáte parametr PfxFilePath.

Typ:Byte[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PfxFilePath

Určuje cestu k souboru certifikátu ve formátu .pfx pro vytvoření a nahrání. Tento parametr se vyžaduje, pokud nezadáte parametr PfxBytes.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PfxPassword

Určuje heslo pro certifikát.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

PsApiManagementContext

String

Byte[]

Výstupy

PsApiManagementCertificate