Udostępnij za pośrednictwem

New-AzApiManagementCertificate

  • Odwołanie
Moduł:
Az.ApiManagement

Tworzy certyfikat usługi API Management do użycia podczas uwierzytelniania za pomocą zaplecza.

Składnia

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>]

Opis

Polecenie cmdlet New-AzApiManagementCertificate tworzy certyfikat usługi Azure API Management.

Przykłady

Przykład 1. Tworzenie i przekazywanie certyfikatu

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

To polecenie przekazuje certyfikat do usługi Api Management. Ten certyfikat może służyć do wzajemnego uwierzytelniania z zapleczem przy użyciu zasad.

Przykład 2

Tworzy certyfikat usługi API Management do użycia podczas uwierzytelniania za pomocą zaplecza. (automatycznie wygenerowane)

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

Przykład 3: Tworzenie certyfikatu keyVault

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

Pierwsze polecenie tworzy magazyn kluczy. Drugie polecenie tworzy certyfikat przy użyciu wpisu tajnego z tego magazynu kluczy.

Parametry

-CertificateId

Określa identyfikator certyfikatu do utworzenia. Jeśli nie określisz tego parametru, zostanie wygenerowany identyfikator.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Context

Określa obiekt PsApiManagementContext.

Typ:PsApiManagementContext
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-KeyVault

Usługa KeyVault używana do pobierania danych certyfikatu. Ten parametr jest wymagany, jeśli nie określono -PfxFilePath. Aby uzyskać szczegółowe informacje, zobacz New-AzApiManagementKeyVaultObject.

Typ:PsApiManagementKeyVaultEntity
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PfxBytes

Określa tablicę bajtów pliku certyfikatu w formacie pfx. Ten parametr jest wymagany, jeśli nie określisz parametru PfxFilePath.

Typ:Byte[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PfxFilePath

Określa ścieżkę do pliku certyfikatu w formacie pfx, aby utworzyć i przekazać. Ten parametr jest wymagany, jeśli nie określisz parametru PfxBytes.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PfxPassword

Określa hasło certyfikatu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Byte[]

Dane wyjściowe