Set-AzApiManagementCertificate

修改已設定為與後端進行相互驗證的 API 管理 憑證。

Syntax

Set-AzApiManagementCertificate
   -Context <PsApiManagementContext>
   -CertificateId <String>
   [-PfxFilePath <String>]
   [-PfxPassword <String>]
   [-PassThru]
   [-KeyVault <PsApiManagementKeyVaultEntity>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzApiManagementCertificate
   -Context <PsApiManagementContext>
   -CertificateId <String>
   [-PfxBytes <Byte[]>]
   [-PfxPassword <String>]
   [-PassThru]
   [-KeyVault <PsApiManagementKeyVaultEntity>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzApiManagementCertificate Cmdlet 會修改 Azure API 管理 憑證。

範例

範例 1:修改憑證

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Set-AzApiManagementCertificate -Context $ApiMgmtContext -CertificateId "0123456789" -PfxFilePath "C:\contoso\certificates\apimanagementnew.pfx" -PfxPassword "2222"

此命令會修改指定的 API 管理 憑證。

參數

-CertificateId

指定要修改之憑證的標識碼。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Context

指定 PsApiManagementContext 物件。

Type:PsApiManagementContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVault

用來擷取憑證數據的KeyVault。如果未指定 -PfxFilePath,則需要此參數。

Type:PsApiManagementKeyVaultEntity
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

passthru

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PfxBytes

以 .pfx 格式指定憑證檔案的位元組陣列。 如果您未指定 PfxFilePath 參數,則需要此參數。

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PfxFilePath

以 .pfx 格式指定憑證檔案的路徑,以建立和上傳。 如果您未指定 PfxBytes 參數,則需要此參數。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PfxPassword

指定憑證的密碼。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

輸入

PsApiManagementContext

String

Byte[]

SwitchParameter

輸出

PsApiManagementCertificate