New-AzApiManagementCertificate
建立 API 管理 憑證，以在向後端進行驗證期間使用。
語法
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 會建立 Azure API 管理 憑證。
範例
範例 1：建立和上傳憑證
$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
New-AzApiManagementCertificate -Context $ApiMgmtContext -PfxFilePath "C:\contoso\certificates\apimanagement.pfx" -PfxPassword "1111"此命令會將憑證上傳至 Api 管理。 此憑證可用於使用原則與後端進行相互驗證。
範例 2
建立 API 管理 憑證，以在向後端進行驗證期間使用。 （ 自動產生 ）
New-AzApiManagementCertificate -CertificateId '0123456789' -Context <PsApiManagementContext> -PfxFilePath 'C:\contoso\certificates\apimanagement.pfx' -PfxPassword '1111'範例 3：建立 keyVault 憑證
$secretIdentifier = 'https://contoso.vault.azure.net/secrets/xxxx'
$keyvault = New-AzApiManagementKeyVaultObject -SecretIdentifier $secretIdentifier
$keyVaultcert = New-AzApiManagementCertificate -Context $context -CertificateId $kvcertId -KeyVault $keyvault第一個命令會建立keyvault。 第二個命令會使用此keyvault的秘密來建立憑證。
參數
-CertificateId
指定要建立之憑證的標識碼。 如果您未指定此參數，就會為您產生識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Context
指定 PsApiManagementContext 物件。
| 類型: | PsApiManagementContext |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-KeyVault
用來擷取憑證數據的KeyVault。如果未指定 -PfxFilePath，則需要此參數。 如需詳細資訊，請參閱 New-AzApiManagementKeyVaultObject。
| 類型: | PsApiManagementKeyVaultEntity |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PfxBytes
以 .pfx 格式指定憑證檔案的位元組陣列。 如果您未指定 PfxFilePath 參數，則需要此參數。
| 類型: | Byte[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PfxFilePath
以 .pfx 格式指定憑證檔案的路徑，以建立和上傳。 如果您未指定 PfxBytes 參數，則需要此參數。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PfxPassword
指定憑證的密碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
輸入
Byte[]