Auf Englisch lesen

Freigeben über

Set-AzApiManagementCertificate

  • Referenz
Modul:
Az.ApiManagement

Ändert ein API-Verwaltungszertifikat, das für die gegenseitige Authentifizierung mit Back-End konfiguriert ist.

Syntax

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

Beschreibung

Das cmdlet Set-AzApiManagementCertificate ändert ein Azure API Management-Zertifikat.

Beispiele

Beispiel 1: Ändern eines Zertifikats

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

Mit diesem Befehl wird das angegebene API-Verwaltungszertifikat geändert.

Parameter

-CertificateId

Gibt die ID des zu ändernden Zertifikats an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Context

Gibt ein PsApiManagementContext- -Objekt an.

Typ:PsApiManagementContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVault

KeyVault zum Abrufen von Zertifikatdaten. Dieser Parameter ist erforderlich, wenn -PfxFilePath nicht angegeben ist.

Typ:PsApiManagementKeyVaultEntity
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

passthru

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PfxBytes

Gibt ein Array von Bytes der Zertifikatdatei im PFX-Format an. Dieser Parameter ist erforderlich, wenn Sie den PfxFilePath Parameter nicht angeben.

Typ:Byte[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PfxFilePath

Gibt den Pfad zur Zertifikatdatei im PFX-Format an, das erstellt und hochgeladen werden soll. Dieser Parameter ist erforderlich, wenn Sie den parameter PfxBytes nicht angeben.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PfxPassword

Gibt das Kennwort für das Zertifikat an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Byte[]

Ausgaben