az network application-gateway
管理應用層級路由和負載平衡服務。
若要深入瞭解 應用程式閘道,請瀏覽 https://learn.microsoft.com/en-us/azure/application-gateway/quick-create-cli。
命令
az network application-gateway create
建立應用程式閘道。
az network application-gateway create --name
--resource-group
[--capacity]
[--cert-file]
[--cert-password]
[--connection-draining-timeout]
[--custom-error-pages]
[--enable-private-link]
[--frontend-port]
[--http-settings-cookie-based-affinity {Disabled, Enabled}]
[--http-settings-port]
[--http-settings-protocol {Http, Https, Tcp, Tls}]
[--http2 {Disabled, Enabled}]
[--identity]
[--key-vault-secret-id]
[--location]
[--max-capacity]
[--min-capacity]
[--no-wait]
[--priority]
[--private-ip-address]
[--private-link-ip-address]
[--private-link-primary {false, true}]
[--private-link-subnet]
[--private-link-subnet-prefix]
[--public-ip-address]
[--public-ip-address-allocation]
[--routing-rule-type {Basic, PathBasedRouting}]
[--servers]
[--sku {Standard_Medium, Standard_Small, Standard_v2, WAF_Large, WAF_Medium, WAF_v2}]
[--ssl-certificate-name]
[--ssl-profile]
[--ssl-profile-id]
[--subnet]
[--subnet-address-prefix]
[--tags]
[--trusted-client-cert]
[--validate]
[--vnet-address-prefix]
[--vnet-name]
[--waf-policy]
[--zones]
範例
建立應用程式閘道。
az network application-gateway create --capacity 2 --frontend-port MyFrontendPort --http-settings-cookie-based-affinity Enabled --http-settings-port 80 --http-settings-protocol Http --location westus2 --name MyAppGateway --public-ip-address MyAppGatewayPublicIp --resource-group MyResourceGroup --sku Standard_Small --subnet MySubnet --vnet-name MyVNet
建立具有 VM 作為後端伺服器的應用程式閘道。
az network application-gateway create -g MyResourceGroup -n MyAppGateway --capacity 2 --sku Standard_Medium --vnet-name MyVNet --subnet MySubnet --http-settings-cookie-based-affinity Enabled --public-ip-address MyAppGatewayPublicIp --servers 10.0.0.4 10.0.0.5
使用 SSL 設定檔建立應用程式閘道。
az network application-gateway create -n MyAppGateway -g MyResourceGroup --public-ip-address MyPublicIP --sku Standard_v2 --priority 1001 --ssl-profile name=MyProfile min-protocol-version=TLSv1_0 cipher-suites=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 policy-type=Custom client-auth-configuration=True
必要參數
應用程式閘道的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
選擇性參數
要與應用程式閘道搭配使用的實例數目。
PFX 憑證檔案的路徑。
憑證密碼。
在後端伺服器移除之後的秒數,開啟的聯機會保持作用中。 範圍:0(已停用)至 3600。
格式自定義錯誤頁面 STATUS_CODE=URL
的空間分隔清單。
啟用此應用程式閘道的 Private Link 功能。 如果公用IP和私人IP都已平衡,則只會在公用前端IP中生效。
前埠號碼。
啟用或停用 HTTP 設定 Cookie 型親和性。
HTTP 設定埠。
HTTP 設定通訊協定。
針對應用程式閘道使用 HTTP2。
ManagedIdentity 資源的名稱或標識碼。
秘密標識碼 (base-64 編碼的未加密 pfx) 'Secret' 或 'Certificate' 物件儲存在 Azure KeyVault 中。 您需要啟用keyvault的虛刪除,才能使用此功能。
位置。 來自的值: az account list-locations
。 您可以使用 az configure --defaults location=<location>
設定預設位置。
應用程式閘道實例數目的上限。
應用程式閘道實例數目的下限。
請勿等候長時間執行的作業完成。
要求路由規則的優先順序。 支援的 SKU 層是Standard_v2,WAF_v2。
要使用的靜態私人IP位址。
Private Link 子網的靜態私人 IP 位址。 如果省略,將會建立動態專案。
IP 組態是否為主要組態。
應用程式閘道相同 vnet 內的子網名稱。
建立新子網時要使用的CIDR 前置詞。
公用IP位址名稱或識別碼。 使用現有的資源,或在指定時建立新的資源,如果省略則為 none。
建立新的公用IP時要使用的IP配置類型。
要求路由規則類型。
與後端伺服器對應的IP位址或 DNS 名稱以空格分隔的清單。
SKU 的名稱。
憑證名稱。 預設值為 <application-gateway-name>SslCert
。
應用程式閘道 ssl 設定檔。
使用方式:--ssl-profile name=MySslProfile client-auth-configuration=True cipher-suites=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 policy-type=Custom min-protocol-version=TLSv1_0
名稱:必要。 應用程式閘道 內唯一的 SSL 配置檔名稱。 polic-name:Ssl 原則的名稱。 policy-type:Ssl 原則的類型。 min-protocol-version:應用程式閘道支援的最低 Ssl 通訊協定版本。 加密套件:要以指定順序對應用程式閘道啟用的 Ssl 加密套件。 disabled-ssl-protocol:要停用的通訊協議空間分隔清單。 trusted-client-certificates:應用程式網關受信任客戶端憑證的參考陣列。 client-auth-configuration:應用程式閘道資源的客戶端驗證組態。
您可以使用多個 --ssl-profile
自變數來指定多個 SSL 設定檔。
應用程式閘道的 SSL 設定檔資源。
子網的名稱或標識碼。 如果資源不存在,將會建立資源。 如果指定名稱,也指定 --vnet-name。 如果您想要在其他資源群組或訂用帳戶中使用現有的子網,請提供標識碼,而不是子網的名稱。
建立新子網時要使用的CIDR 前置詞。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
應用程式閘道受信任的客戶端憑證。
使用方式:--trusted-client-certificates name=client1 data=client.cer
名稱:必要。 應用程式閘道 數據內唯一的信任客戶端憑證名稱:必要。 憑證公用數據。
您可以使用多個 --trusted-client-certificates
自變數來指定多個受信任的客戶端憑證。
產生並驗證 ARM 範本,而不需建立任何資源。
建立新 VNet 時要使用的 CIDR 前置詞。
虛擬網路 (VNet) 名稱。
Web 應用程式防火牆 (WAF) 原則的名稱或標識碼。
要在其中布建資源的可用性區域空間分隔清單。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway delete
刪除應用程式閘道。
az network application-gateway delete [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
刪除應用程式閘道。
az network application-gateway delete -g MyResourceGroup -n MyAppGateway
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
應用程式閘道的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway list
列出應用程式閘道。
az network application-gateway list [--max-items]
[--next-token]
[--resource-group]
範例
列出應用程式閘道。
az network application-gateway list -g MyResourceGroup
選擇性參數
命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值,則會在命令的輸出中提供令牌。 若要繼續分頁,請在後續命令的自變數中 --next-token
提供令牌值。
標記,指定要開始分頁的位置。 這是先前截斷回應中的令牌值。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway show
取得應用程式閘道的詳細數據。
az network application-gateway show [--ids]
[--name]
[--resource-group]
[--subscription]
範例
取得應用程式閘道的詳細數據。
az network application-gateway show -g MyResourceGroup -n MyAppGateway
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
應用程式閘道的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway show-backend-health
取得應用程式閘道後端健康情況的相關信息。
az network application-gateway show-backend-health [--address-pool]
[--expand]
[--host]
[--host-name-from-http-settings {false, true}]
[--http-settings]
[--ids]
[--match-body]
[--match-status-codes]
[--name]
[--path]
[--protocol {Http, Https, Tcp, Tls}]
[--resource-group]
[--subscription]
[--timeout]
範例
顯示應用程式閘道的後端健康情況。
az network application-gateway show-backend-health -g MyResourceGroup -n MyAppGateway
顯示應用程式閘道的後端健康情況,以取得後端集區和 HTTP 設定的組合。
az network application-gateway show-backend-health -g MyResourceGroup -n MyAppGateway --host-name-from-http-settings --path /test --timeout 100 --http-settings appGatewayBackendHttpSettings --address-pool appGatewayBackendPool
選擇性參數
後端位址池的名稱或標識碼。
展開 BackendAddressPool 和 BackendHttp 設定 後端健康狀態中所參考。
要傳送探查的主機名稱。
從 HTTP 設定使用主機標頭。
HTTP 設定的名稱或識別碼。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
必須包含在健康情況回應中的主體。
健康情況回應之允許狀態代碼範圍的空間分隔清單。
應用程式閘道的名稱。
探查的相對路徑。 有效的路徑從 “/” 開始。
HTTP 設定通訊協定。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
探查逾時以秒為單位。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway start
啟動應用程式閘道。
az network application-gateway start [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
啟動應用程式閘道。
az network application-gateway start -g MyResourceGroup -n MyAppGateway
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
應用程式閘道的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway stop
停止應用程式閘道。
az network application-gateway stop [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
範例
停止應用程式閘道。
az network application-gateway stop -g MyResourceGroup -n MyAppGateway
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
應用程式閘道的名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway update
更新應用程式閘道。
az network application-gateway update [--add]
[--capacity]
[--custom-error-pages]
[--family {Generation_1, Generation_2}]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--http2 {Disabled, Enabled}]
[--identity]
[--ids]
[--max-capacity]
[--min-capacity]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--remove]
[--resource-group]
[--set]
[--sku {Basic, Standard_Large, Standard_Medium, Standard_Small, Standard_v2, WAF_Large, WAF_Medium, WAF_v2}]
[--ssl-profiles]
[--subscription]
[--tags]
範例
更新應用程式閘道。
az network application-gateway update --name MyApplicationGateway --resource-group MyResourceGroup --set sku.tier=WAF_v2
透過 OCSP 啟用客戶端憑證撤銷。
az network application-gateway update -n MyApplicationGateway --ssl-profiles [0].client-auth-configuration.verify-client-revocation=OCSP
選擇性參數
藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value、string 或 JSON 字串>。
要與應用程式閘道搭配使用的實例數目。
格式自定義錯誤頁面 STATUS_CODE=URL
的空間分隔清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
應用程式閘道 SKU 系列。
使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。
針對應用程式閘道使用 HTTP2。
如果已設定,則為應用程式閘道的身分識別。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
應用程式閘道實例數目的上限。
應用程式閘道實例數目的下限。
應用程式閘道的名稱。
請勿等候長時間執行的作業完成。
從清單中移除屬性或專案。 範例:--remove property.list OR --remove 屬性ToRemove。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=。
應用程式閘道 SKU 的名稱。
應用程式閘道資源的 SSL 設定檔。 如需預設限制,請參閱 應用程式閘道 限制。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
以空格分隔的標記:key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az network application-gateway wait
將 CLI 置於等候狀態,直到符合條件為止。
az network application-gateway wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
選擇性參數
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到刪除為止。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
輪詢間隔以秒為單位。
應用程式閘道的名稱。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。