共用方式為

Export-AzApiManagementApi

  • 參考
模組:
Az.ApiManagement

將 API 匯出至檔案。

語法

Export-AzApiManagementApi
      -Context <PsApiManagementContext>
      -ApiId <String>
      [-ApiRevision <String>]
      -SpecificationFormat <PsApiManagementApiFormat>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-AzApiManagementApi
      -Context <PsApiManagementContext>
      -ApiId <String>
      [-ApiRevision <String>]
      -SpecificationFormat <PsApiManagementApiFormat>
      -SaveAs <String>
      [-Force]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Export-AzApiManagementApi Cmdlet 會將 Azure API 管理 API 匯出至其中一個支援格式的檔案。

範例

範例 1：以 Web 應用程式描述語言匯出 API（WADL） 格式

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Export-AzApiManagementApi -Context $ApiMgmtContext -ApiId "0123456789" -SpecificationFormat "Wadl" -SaveAs "C:\contoso\specifications\0123456789.wadl"

此命令會將 API 匯出至 WADL 檔案。

範例 2：將 OpenApi 3.0 規格格式中的 API 匯出為 Json 檔

$ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
Export-AzApiManagementApi -Context $ApiMgmtContext -ApiId swagger-petstore -SpecificationFormat OpenApiJson -SaveAs D:\github\petstore.json

此命令會將 Open Api 格式的 API 定義匯出為 Json 檔

參數

-ApiId

指定要匯出之 API 的識別碼。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ApiRevision

API 修訂的標識碼。 這是選擇性參數。 如果未指定，則會針對目前作用中的 API 修訂完成匯出。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Context

指定 PsApiManagementContext 物件。

類型:PsApiManagementContext
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Force

指出如果檔案已經存在，這項作業就會覆寫同名的檔案。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-PassThru

指出如果成功匯出 API，或$False，這個作業會傳回$True。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-SaveAs

指定要儲存匯出 API 的檔案路徑。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-SpecificationFormat

指定 API 格式。 psdx_paramvalues Wadl、Wsdl、Swagger、OpenApi 和 OpenApiJson

類型:PsApiManagementApiFormat
接受的值:Wadl, Swagger, Wsdl, OpenApi, OpenApiJson
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

PsApiManagementContext

String

PsApiManagementApiFormat

SwitchParameter

輸出

String