Aracılığıyla paylaş

New-AzApiManagementCertificate

  • Başvuru
Modül:
Az.ApiManagement

Arka Uçla Kimlik Doğrulaması sırasında kullanılacak bir API Management sertifikası oluşturur.

Sözdizimi

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

New-AzApiManagementCertificate cmdlet'i bir Azure API Management sertifikası oluşturur.

Örnekler

Örnek 1: Sertifika oluşturma ve karşıya yükleme

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

Bu komut Api Management'a bir sertifika yükler. Bu sertifika, ilkeler kullanılarak arka uçla karşılıklı kimlik doğrulaması için kullanılabilir.

Örnek 2

Arka Uçla Kimlik Doğrulaması sırasında kullanılacak bir API Management sertifikası oluşturur. (otomatik olarak oluşturulmuş)

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

Örnek 3 : KeyVault Sertifikası oluşturma

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

İlk komut bir keyvault oluşturur. İkinci komut, bu keyvault'tan gizli dizi kullanarak bir sertifika oluşturur.

Parametreler

-CertificateId

Oluşturulacak sertifikanın kimliğini belirtir. Bu parametreyi belirtmezseniz, sizin için bir kimlik oluşturulur.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Context

PsApiManagementContext nesnesini belirtir.

Tür:PsApiManagementContext
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-KeyVault

Sertifika verilerini getirmek için kullanılan KeyVault. -PfxFilePath belirtilmezse bu parametre gereklidir. Ayrıntılar için bkz. New-AzApiManagementKeyVaultObject.

Tür:PsApiManagementKeyVaultEntity
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PfxBytes

Sertifika dosyasının bayt dizisini .pfx biçiminde belirtir. PfxFilePath parametresini belirtmezseniz bu parametre gereklidir.

Tür:Byte[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PfxFilePath

Oluşturulacak ve karşıya yüklenecek sertifika dosyasının yolunu .pfx biçiminde belirtir. PfxBytes parametresini belirtmezseniz bu parametre gereklidir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PfxPassword

Sertifikanın parolasını belirtir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

PsApiManagementContext

String

Byte[]

Çıkışlar

PsApiManagementCertificate