Set-AzApiManagementCertificate

  • Referenz
Modul:
Az.ApiManagement

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

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

Beschreibung

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

Beispiele

Beispiel 1: Ändern eines Zertifikats

$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.

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

-Context

Gibt ein PsApiManagementContext -Objekt an.

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

-DefaultProfile

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

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

-KeyVault

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

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

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

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-PfxPassword

Gibt das Kennwort für das Zertifikat an.

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

Eingaben

PsApiManagementContext

String

Byte[]

SwitchParameter

Ausgaben

PsApiManagementCertificate