az postgres flexible-server

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器。

命令

名稱	Description	類型	狀態
az postgres flexible-server ad-admin	管理伺服器 Active Directory 系統管理員。	核心	GA
az postgres flexible-server ad-admin create	建立 Active Directory 系統管理員。	核心	GA
az postgres flexible-server ad-admin delete	刪除 Active Directory 系統管理員。	核心	GA
az postgres flexible-server ad-admin list	列出所有 Active Directory 系統管理員。	核心	GA
az postgres flexible-server ad-admin show	取得 Active Directory 系統管理員。	核心	GA
az postgres flexible-server ad-admin wait	等候 Active Directory 系統管理員滿足特定條件。	核心	GA
az postgres flexible-server advanced-threat-protection-setting	管理 PostgreSQL 彈性伺服器的進階威脅防護設定。	核心	GA
az postgres flexible-server advanced-threat-protection-setting show	取得 PostgreSL 彈性伺服器的進階威脅防護設定。	核心	GA
az postgres flexible-server advanced-threat-protection-setting update	更新 彈性伺服器的進階威脅防護設定狀態。	核心	GA
az postgres flexible-server backup	管理彈性伺服器備份。	核心	GA
az postgres flexible-server backup list	列出指定伺服器的所有備份。	核心	GA
az postgres flexible-server backup show	顯示指定伺服器之特定備份的詳細數據。	核心	GA
az postgres flexible-server connect	連線 至彈性伺服器。	副檔名	GA
az postgres flexible-server create	建立 PostgreSQL 彈性伺服器。	核心	GA
az postgres flexible-server db	在彈性伺服器上管理 PostgreSQL 資料庫。	核心	GA
az postgres flexible-server db create	在彈性伺服器上建立 PostgreSQL 資料庫。	核心	GA
az postgres flexible-server db delete	刪除彈性伺服器上的資料庫。	核心	GA
az postgres flexible-server db list	列出彈性伺服器的資料庫。	核心	GA
az postgres flexible-server db show	顯示資料庫的詳細數據。	核心	GA
az postgres flexible-server delete	刪除彈性伺服器。	核心	GA
az postgres flexible-server deploy	啟用並執行 PostgreSQL 伺服器的 GitHub Actions 工作流程。	核心	GA
az postgres flexible-server deploy run	在 github 存放庫中執行現有的工作流程。	核心	GA
az postgres flexible-server deploy setup	建立 PostgreSQL 伺服器的 GitHub Actions 工作流程檔案。	核心	GA
az postgres flexible-server execute	連線 彈性伺服器。	副檔名	GA
az postgres flexible-server firewall-rule	管理伺服器的防火牆規則。	核心	GA
az postgres flexible-server firewall-rule create	為彈性伺服器建立新的防火牆規則。	核心	GA
az postgres flexible-server firewall-rule delete	刪除防火牆規則。	核心	GA
az postgres flexible-server firewall-rule list	列出彈性伺服器的所有防火牆規則。	核心	GA
az postgres flexible-server firewall-rule show	取得防火牆規則的詳細數據。	核心	GA
az postgres flexible-server firewall-rule update	更新防火牆規則。	核心	GA
az postgres flexible-server geo-restore	從備份異地還原彈性伺服器。	核心	GA
az postgres flexible-server identity	管理伺服器使用者指派的身分識別。	核心	GA
az postgres flexible-server identity assign	將使用者已簽署的受控識別新增至伺服器。	核心	GA
az postgres flexible-server identity list	列出來自伺服器的所有使用者指派受控識別。	核心	GA
az postgres flexible-server identity remove	從伺服器移除使用者已簽署的受控識別。	核心	GA
az postgres flexible-server identity show	從伺服器取得使用者指派的受控識別。	核心	GA
az postgres flexible-server list	列出可用的彈性伺服器。	核心	GA
az postgres flexible-server list-skus	列出指定區域中可用的 SKU。	核心	GA
az postgres flexible-server migration	管理 PostgreSQL 彈性伺服器的移轉工作流程。	核心	GA
az postgres flexible-server migration check-name-availability	檢查是否可使用提供的移轉名稱。	核心	GA
az postgres flexible-server migration create	為彈性伺服器建立新的移轉工作流程。	核心	GA
az postgres flexible-server migration list	列出彈性伺服器的移轉。	核心	GA
az postgres flexible-server migration show	取得特定移轉的詳細數據。	核心	GA
az postgres flexible-server migration update	更新特定的移轉。	核心	GA
az postgres flexible-server parameter	管理彈性伺服器之伺服器參數值的命令。	核心	GA
az postgres flexible-server parameter list	列出彈性伺服器的參數值。	核心	GA
az postgres flexible-server parameter set	更新彈性伺服器的參數。	核心	GA
az postgres flexible-server parameter show	取得彈性伺服器的參數。」。	核心	GA
az postgres flexible-server private-endpoint-connection	管理 PostgreSQL 彈性伺服器私人端點連線。	核心	GA
az postgres flexible-server private-endpoint-connection approve	核准與 PostgreSQL 彈性伺服器相關聯的指定私人端點連線。	核心	GA
az postgres flexible-server private-endpoint-connection delete	刪除與 PostgreSQL 彈性伺服器相關聯的指定私人端點連線。	核心	GA
az postgres flexible-server private-endpoint-connection list	列出與 PostgreSQL 彈性伺服器相關聯的所有私人端點連線。	核心	GA
az postgres flexible-server private-endpoint-connection reject	拒絕與 PostgreSQL 彈性伺服器相關聯的指定私人端點連線。	核心	GA
az postgres flexible-server private-endpoint-connection show	顯示與 PostgreSQL 彈性伺服器相關聯的私人端點連線詳細數據。	核心	GA
az postgres flexible-server private-link-resource	取得 PostgreSQL 彈性伺服器的私人鏈接資源。	核心	GA
az postgres flexible-server private-link-resource list	列出與 PostgreSQL 彈性伺服器相關聯的私人鏈接資源。	核心	GA
az postgres flexible-server private-link-resource show	取得 PostgreSQL 彈性伺服器的私人鏈接資源。	核心	GA
az postgres flexible-server replica	管理讀取複本。	核心	GA
az postgres flexible-server replica create	建立伺服器的讀取複本。	核心	GA
az postgres flexible-server replica list	列出指定伺服器的所有讀取複本。	核心	GA
az postgres flexible-server replica promote	停止複寫讀取複本，並將其升級為獨立伺服器或主伺服器。	核心	GA
az postgres flexible-server replica stop-replication	停止複寫至讀取複本，並將其設為讀取/寫入伺服器。	核心	已取代
az postgres flexible-server restart	重新啟動彈性伺服器。	核心	GA
az postgres flexible-server restore	從備份還原彈性伺服器。	核心	GA
az postgres flexible-server revive-dropped	從備份中恢復已卸除的彈性伺服器。	核心	GA
az postgres flexible-server server-logs	管理 PostgreSQL 彈性伺服器的伺服器記錄檔（記錄檔）。	核心	GA
az postgres flexible-server server-logs download	下載 PostgreSQL 彈性伺服器的記錄檔。	核心	GA
az postgres flexible-server server-logs list	列出 PostgreSQL 彈性伺服器的記錄檔。	核心	GA
az postgres flexible-server show	取得彈性伺服器的詳細數據。	核心	GA
az postgres flexible-server show-connection-string	顯示 PostgreSQL 彈性伺服器資料庫的 連接字串。	核心	GA
az postgres flexible-server start	啟動彈性伺服器。	核心	GA
az postgres flexible-server stop	停止彈性伺服器。	核心	GA
az postgres flexible-server update	更新彈性伺服器。	核心	GA
az postgres flexible-server upgrade	升級彈性伺服器的主要版本。	核心	GA
az postgres flexible-server virtual-endpoint	管理 PostgreSQL 彈性伺服器的虛擬端點。	核心	GA
az postgres flexible-server virtual-endpoint create	為彈性伺服器建立新的虛擬端點。	核心	GA
az postgres flexible-server virtual-endpoint delete	刪除虛擬端點。	核心	GA
az postgres flexible-server virtual-endpoint list	列出彈性伺服器的所有虛擬端點。	核心	GA
az postgres flexible-server virtual-endpoint show	取得虛擬端點的詳細數據。	核心	GA
az postgres flexible-server virtual-endpoint update	更新虛擬端點。	核心	GA
az postgres flexible-server wait	等候彈性伺服器滿足特定條件。	核心	GA

az postgres flexible-server connect

連線 彈性伺服器。

az postgres flexible-server connect --admin-user
                                    --name
                                    [--admin-password]
                                    [--database-name]
                                    [--interactive]
                                    [--querytext]

必要參數

--admin-user -u

系統管理員的登入用戶名稱。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

選擇性參數

--admin-password -p

系統管理員的登入密碼。

--database-name -d

資料庫的名稱。

--interactive

傳遞此參數以在互動式模式中連線到資料庫。

--querytext -q

已被取代

自變數 'querytext' 已被取代，並將在未來版本中移除。 請改用 『execute』。

針對彈性伺服器執行的查詢。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server create

建立 PostgreSQL 彈性伺服器。

建立具有自定義或預設組態的PostgreSQL彈性伺服器。 如需網路設定的詳細資訊，請參閱

• 設定公用存取 https://docs.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-manage-firewall-cli
• 設定私人存取 https://docs.microsoft.com/en-us/azure/postgresql/flexible-server/how-to-manage-virtual-network-cli。

az postgres flexible-server create [--active-directory-auth {Disabled, Enabled}]
                                   [--address-prefixes]
                                   [--admin-password]
                                   [--admin-user]
                                   [--backup-identity]
                                   [--backup-key]
                                   [--backup-retention]
                                   [--database-name]
                                   [--geo-redundant-backup {Disabled, Enabled}]
                                   [--high-availability {Disabled, SameZone, ZoneRedundant}]
                                   [--identity]
                                   [--iops]
                                   [--key]
                                   [--location]
                                   [--name]
                                   [--password-auth {Disabled, Enabled}]
                                   [--performance-tier]
                                   [--private-dns-zone]
                                   [--public-access]
                                   [--resource-group]
                                   [--sku-name]
                                   [--standby-zone]
                                   [--storage-auto-grow {Disabled, Enabled}]
                                   [--storage-size]
                                   [--storage-type {PremiumV2_LRS, Premium_LRS}]
                                   [--subnet]
                                   [--subnet-prefixes]
                                   [--tags]
                                   [--throughput]
                                   [--tier]
                                   [--version]
                                   [--vnet]
                                   [--yes]
                                   [--zone]

範例

使用自定義參數建立PostgreSQL彈性伺服器

az postgres flexible-server create --location northeurope --resource-group testGroup \
  --name testserver --admin-user username --admin-password password \
  --sku-name Standard_B1ms --tier Burstable --public-access 153.24.26.117 --storage-size 128 \
  --tags "key=value" --version 13 --high-availability ZoneRedundant --zone 1 \
  --standby-zone 3

使用 進階版 SSD v2 磁碟建立 PostgreSQL 彈性伺服器。

# set storage type to "PremiumV2_LRS" and provide values for Storage size (in GiB), IOPS (operations/sec), and Throughput (MB/sec).
az postgres flexible-server create --location northeurope --resource-group testGroup \
    --name testserver --admin-user username --admin-password password \
    --sku-name Standard_B1ms --tier Burstable --storage-type PremiumV2_LRS --storage-size 128 --iops 3000 --throughput 125

建立 PostgreSQL 彈性伺服器，預設會啟用預設參數和公用存取。 CLI 將會建立資源群組、伺服器名稱、使用者名稱、密碼和預設資料庫

az postgres flexible-server create

建立具有公用存取權的 PostgreSQL 彈性伺服器，並新增 IP 位址範圍以存取此伺服器。 --public-access 參數可以是 'All'、'None'、 <startIpAddress>或 <startIpAddress>-<endIpAddress>

az postgres flexible-server create --resource-group testGroup --name testserver --public-access 125.23.54.31-125.23.54.35

建立具有私人存取權的PostgreSQL彈性伺服器。 如果提供的虛擬網路和子網不存在，將會建立具有指定位址前綴的虛擬網路和子網。

az postgres flexible-server create --resource-group testGroup --name testserver --vnet myVnet --subnet mySubnet --address-prefixes 10.0.0.0/16 --subnet-prefixes 10.0.0.0/24

使用新的子網資源標識碼和新的私人 DNS 區域資源識別碼，建立 PostgreSQL 彈性伺服器。 您可以在不同的訂用帳戶或資源群組中建立子網和 DNS 區域。

az postgres flexible-server create \
  --resource-group testGroup --name testserver \
  --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNetName}/subnets/{SubnetName} \
  --private-dns-zone /subscriptions/{SubID}/resourceGroups/{resourceGroup}/providers/Microsoft.Network/privateDnsZones/testPostgreSQLFlexibleDnsZone.private.postgres.database.azure.com \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24

使用相同資源群組中的現有網路資源建立PostgreSQL彈性伺服器。 提供的子網不應部署任何其他資源，如果尚未委派，此子網將會委派給 Microsoft.DBforPostgreSQL/flexibleServers。 如果尚未連結，私人 DNS 區域將會連結至虛擬網路。

# create vnet
az network vnet create --resource-group testGroup --name testVnet --location testLocation --address-prefixes 172.0.0.0/16

# create subnet
az network vnet subnet create --resource-group testGroup --vnet-name testVnet --address-prefixes 172.0.0.0/24 --name testSubnet

# create private dns zone
az network private-dns zone create -g testGroup -n testDNS.private.postgres.database.azure.com

az postgres flexible-server create --resource-group testGroup \
  --name testserver --location testLocation \
  --subnet /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.Network/virtualNetworks/tesetVnet/subnets/testSubnet \
  --private-dns-zone /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com\


az postgres flexible-server create --resource-group testGroup --name testserver \
  --vnet testVnet --subnet testSubnet --location testLocation \
  --private-dns-zone /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com

使用不同資源群組/訂用帳戶中的現有網路資源，建立PostgreSQL彈性伺服器。

az postgres flexible-server create --resource-group testGroup \
   --name testserver --location testLocation \
  --subnet /subscriptions/{SubId2}/resourceGroups/{testGroup2}/providers/Microsoft.Network/virtualNetworks/tesetVnet/subnets/testSubnet \
  --private-dns-zone /subscriptions/{SubId2}/resourceGroups/{testGroup2}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com

使用數據加密建立 PostgreSQL 彈性伺服器。

# create keyvault
az keyvault create -g testGroup -n testVault --location testLocation \
  --enable-purge-protection true


# create key in keyvault and save its key identifier
keyIdentifier=$(az keyvault key create --name testKey -p software \
  --vault-name testVault --query key.kid -o tsv)


# create identity and save its principalId
identityPrincipalId=$(az identity create -g testGroup --name testIdentity \
  --location testLocation --query principalId -o tsv)


# add testIdentity as an access policy with key permissions 'Wrap Key', 'Unwrap Key', 'Get' and 'List' inside testVault
az keyvault set-policy -g testGroup -n testVault --object-id $identityPrincipalId \
  --key-permissions wrapKey unwrapKey get list


# create flexible server with data encryption enabled
az postgres flexible-server create -g testGroup -n testServer --location testLocation \
  --key $keyIdentifier --identity testIdentity

建立具有 Active Directory 驗證和密碼驗證的 PostgreSQL 彈性伺服器。

# create flexible server with aad auth and password auth enabled
az postgres flexible-server create -g testGroup -n testServer --location testLocation \
  --active-directory-auth Enabled

僅建立具有 Active Directory 驗證的 PostgreSQL 彈性伺服器。

# create flexible server with aad only auth and password auth disabled
az postgres flexible-server create -g testGroup -n testServer --location testLocation \
  --active-directory-auth Enabled --password-auth Disabled

建立已啟用公用存取、異地備援備份的 PostgreSQL 彈性伺服器，並新增 IP 位址範圍以存取此伺服器。 --public-access 參數可以是 'All'、'None'、 <startIpAddress>或 <startIpAddress>-<endIpAddress>

az postgres flexible-server create --resource-group testGroup --name testserver --geo-redundant-backup Enabled --public-access 125.23.54.31-125.23.54.35

為已啟用異地執行備份的伺服器建立具有數據加密的 PostgreSQL 彈性伺服器。

# create keyvault
az keyvault create -g testGroup -n testVault --location testLocation \
  --enable-purge-protection true


# create key in keyvault and save its key identifier
keyIdentifier=$(az keyvault key create --name testKey -p software \
  --vault-name testVault --query key.kid -o tsv)


# create identity and save its principalId
identityPrincipalId=$(az identity create -g testGroup --name testIdentity \
  --location testLocation --query principalId -o tsv)


# add testIdentity as an access policy with key permissions 'Wrap Key', 'Unwrap Key', 'Get' and 'List' inside testVault
az keyvault set-policy -g testGroup -n testVault --object-id $identityPrincipalId \
  --key-permissions wrapKey unwrapKey get list

# create keyvault in geo-paired region
az keyvault create -g testGroup -n geoVault --location geoPairedLocation \
  --enable-purge-protection true


# create key in keyvault and save its key identifier
geoKeyIdentifier=$(az keyvault key create --name geoKey -p software \
  --vault-name geoVault --query key.kid -o tsv)


# create identity in geo-raired location and save its principalId
geoIdentityPrincipalId=$(az identity create -g testGroup --name geoIdentity \
  --location geoPairedLocation --query principalId -o tsv)


# add testIdentity as an access policy with key permissions 'Wrap Key', 'Unwrap Key', 'Get' and 'List' inside testVault
az keyvault set-policy -g testGroup -n geoVault --object-id $geoIdentityPrincipalId \
  --key-permissions wrapKey unwrapKey get list


# create flexible server with data encryption enabled for geo-backup Enabled server
az postgres flexible-server create -g testGroup -n testServer --location testLocation --geo-redundant-backup Enabled \
  --key $keyIdentifier --identity testIdentity --backup-key $geoKeyIdentifier --backup-identity geoIdentity

建立具有自定義記憶體效能層級的彈性伺服器。 接受的值 “P4”、“P6”、“P10”、“P15”、“P20”、“P30”、“\ ”P40“、”P50“、”P60“、”P70“、”P80“。 實際允許的值取決於彈性伺服器建立的 --storage-size 選取專案。 \ 記憶體效能層級的預設值取決於針對彈性伺服器建立選取的 --storage 大小。

az postgres flexible-server create -g testGroup -n testServer --location testLocation --performance-tier P15

建立具有記憶體自動成長為 [已啟用] 的彈性伺服器。 接受的值 Enabled / Disabled。 記憶體自動成長的預設值為 「已停用」。

az postgres flexible-server create -g testGroup -n testServer --location testLocation --storage-auto-grow Enabled

選擇性參數

--active-directory-auth

是否啟用 Azure Active Directory 驗證。

接受的值: Disabled, Enabled

預設值: Disabled

--address-prefixes

以 CIDR 格式建立新虛擬網路時要使用的 IP 位址前置碼。 預設值為 10.0.0.0/16。

--admin-password -p

系統管理員的密碼。 最少8個字元，最多128個字元。 密碼必須包含下列三個類別的字元：英文大寫字母、英文小寫字母、數位和非英數位元。

--admin-user -u

伺服器 管理員 istrator 用戶名稱。 設定之後，就無法變更。

預設值: anxiousdunbird1

--backup-identity

數據加密之異地備份使用者身分識別的名稱或資源識別碼。 身分識別必須位於與備份區域相同的區域中。

--backup-key

用於數據加密之異地備份密鑰保存庫金鑰的資源識別碼。 金鑰必須位於與備份區域相同的區域中。

--backup-retention

保留備份的天數。 範圍 7 到 35 天。 預設值為 7 天。

預設值: 7

--database-name -d

布建資料庫伺服器時要建立的資料庫名稱。

--geo-redundant-backup

是否啟用異地備援備份。

接受的值: Disabled, Enabled

預設值: Disabled

--high-availability

啟用 （ZoneRedundant 或 SameZone） 或停用高可用性功能。

接受的值: Disabled, SameZone, ZoneRedundant

預設值: Disabled

--identity

用於數據加密之使用者指派身分識別的名稱或資源識別碼。

--iops

要配置給此伺服器的 IOPS 值（operations/sec）。 只有在彈性伺服器使用 進階版 SSD v2 磁碟時，才能更新此值。

--key

數據加密之主要金鑰保存庫金鑰的資源識別碼。

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--password-auth

是否啟用密碼驗證。

接受的值: Disabled, Enabled

預設值: Enabled

--performance-tier

伺服器的效能層級。

--private-dns-zone

此參數僅適用於具有私人存取權的伺服器。 新或現有私人 DNS 區域的名稱或標識碼。 您可以使用來自相同資源群組、不同資源群組或不同訂用帳戶的私人 DNS 區域。 如果您想要使用來自不同資源群組或訂用帳戶的區域，請提供資源識別碼。如果使用者未提供，CLI 會在與虛擬網路相同的資源群組內建立新的私人 DNS 區域。

--public-access

判斷公用存取。 輸入要包含在允許IP清單中的單一或IP位址範圍。 IP 位址範圍必須以虛線分隔，且不包含任何空格。 指定 0.0.0.0 允許從 Azure 內部署的任何資源進行公用存取，以存取您的伺服器。 將它設定為 「None」 會以公用存取模式設定伺服器，但不會建立防火牆規則。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--sku-name

計算 SKU 的名稱。 遵循Standard_{VM 名稱}的慣例。 範例：Standard_B1ms。

預設值: Standard_D2s_v3

--standby-zone

啟用高可用性時，待命伺服器的可用性區域資訊。

--storage-auto-grow

啟用或停用記憶體的自動成長。 預設值為 Enabled。

接受的值: Disabled, Enabled

預設值: Disabled

--storage-size

伺服器的儲存容量。 最小值為 32 GiB，最大值為 16 TiB。

預設值: 128

--storage-type

伺服器 儲存體類型。 允許的值是 進階版_LRS和 進階版V2_LRS。 預設值為 進階版_LRS。如果使用 進階版V2_LRS，則必須設定iops和輸送量。

接受的值: PremiumV2_LRS, Premium_LRS

--subnet

新或現有子網的名稱或資源標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的子網，請提供資源識別碼，而不是名稱。 請注意，子網將會委派給彈性伺服器。 委派之後，此子網無法用於任何其他類型的 Azure 資源。

--subnet-prefixes

以 CIDR 格式建立新子網時要使用的子網 IP 位址前綴。 預設值為 10.0.0.0/24。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--throughput

伺服器 儲存體 輸送量 ，以 MB/秒為單位。 只有在彈性伺服器使用 進階版 SSD v2 磁碟時，才能更新此值。

--tier

伺服器的計算層。 接受的值：高載、GeneralPurpose、MemoryOptimized。

預設值: GeneralPurpose

--version

伺服器主要版本。

預設值: 13

--vnet

新或現有虛擬網路的名稱或標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的 vnet，請提供資源識別碼。 名稱必須介於 2 到 64 個字元之間。 名稱的開頭必須是字母或數位、以字母、數位或底線結尾，而且只能包含字母、數位、底線、句號或連字元。

--yes -y

不提示確認。

預設值: False

--zone -z

要在其中布建資源的可用性區域。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server delete

刪除彈性伺服器。

az postgres flexible-server delete [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

範例

刪除彈性伺服器。

az postgres flexible-server delete --resource-group testGroup --name testserver

刪除彈性伺服器而不提示或確認。

az postgres flexible-server delete --resource-group testGroup --name testserver --yes

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server execute

連線 彈性伺服器。

az postgres flexible-server execute --admin-password
                                    --admin-user
                                    --name
                                    [--database-name]
                                    [--file-path]
                                    [--querytext]

必要參數

--admin-password -p

系統管理員的登入密碼。

--admin-user -u

系統管理員的登入用戶名稱。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

選擇性參數

--database-name -d

資料庫的名稱。

--file-path -f

要執行的 sql 檔案路徑。

--querytext -q

針對彈性伺服器執行的查詢。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server geo-restore

從備份異地還原彈性伺服器。

az postgres flexible-server geo-restore --location
                                        --source-server
                                        [--address-prefixes]
                                        [--backup-identity]
                                        [--backup-key]
                                        [--geo-redundant-backup {Disabled, Enabled}]
                                        [--identity]
                                        [--ids]
                                        [--key]
                                        [--name]
                                        [--no-wait]
                                        [--private-dns-zone]
                                        [--resource-group]
                                        [--subnet]
                                        [--subnet-prefixes]
                                        [--subscription]
                                        [--vnet]
                                        [--yes]
                                        [--zone]

範例

將公用存取伺服器 'testerver' 異地還原至具有公用存取位置 'newLocation' 的新伺服器 'testerverNew'。

az postgres flexible-server geo-restore --resource-group testGroup --name testserverNew --source-server testserver --location newLocation

異地還原私人存取伺服器 『testerver』 作為具有新子網的新伺服器 『testerverNew』。 將會布建已還原伺服器的新 vnet、子網和私人 DNS 區域。 如需更多私人存取案例，請參閱「彈性伺服器建立」命令。

az postgres flexible-server geo-restore --resource-group testGroup --name testserverNew \
  --source-server testserver --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com --location newLocation

將 「testerver」異地還原至目前的時間點，作為不同訂用帳戶/資源群組中的新伺服器 'testerverNew'。 \ Here --restore-group 適用於目標伺服器的資源群組，而 --source-server 必須以資源標識符的形式傳遞。 \ 此資源識別碼可以位於不同於 az account set 所用訂用帳戶的訂用帳戶中。

az postgres flexible-server geo-restore --resource-group testGroup --name testserverNew --location newLocation \
  --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName}

必要參數

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--source-server

要從中還原的來源伺服器名稱或資源標識碼。

選擇性參數

--address-prefixes

以 CIDR 格式建立新虛擬網路時要使用的 IP 位址前置碼。 預設值為 10.0.0.0/16。

--backup-identity

數據加密之異地備份使用者身分識別的名稱或資源識別碼。 身分識別必須位於與備份區域相同的區域中。

--backup-key

用於數據加密之異地備份密鑰保存庫金鑰的資源識別碼。 金鑰必須位於與備份區域相同的區域中。

--geo-redundant-backup

是否啟用異地備援備份。

接受的值: Disabled, Enabled

預設值: Disabled

--identity

用於數據加密之使用者指派身分識別的名稱或資源識別碼。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--key

數據加密之主要金鑰保存庫金鑰的資源識別碼。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--private-dns-zone

此參數僅適用於具有私人存取權的伺服器。 新或現有私人 DNS 區域的名稱或標識碼。 您可以使用來自相同資源群組、不同資源群組或不同訂用帳戶的私人 DNS 區域。 如果您想要使用來自不同資源群組或訂用帳戶的區域，請提供資源識別碼。如果使用者未提供，CLI 會在與虛擬網路相同的資源群組內建立新的私人 DNS 區域。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subnet

新或現有子網的名稱或資源標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的子網，請提供資源識別碼，而不是名稱。 請注意，子網將會委派給彈性伺服器。 委派之後，此子網無法用於任何其他類型的 Azure 資源。

--subnet-prefixes

以 CIDR 格式建立新子網時要使用的子網 IP 位址前綴。 預設值為 10.0.0.0/24。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--vnet

新或現有虛擬網路的名稱或標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的 vnet，請提供資源識別碼。 名稱必須介於 2 到 64 個字元之間。 名稱的開頭必須是字母或數位、以字母、數位或底線結尾，而且只能包含字母、數位、底線、句號或連字元。

--yes -y

不提示確認。

預設值: False

--zone -z

要在其中布建資源的可用性區域。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server list

列出可用的彈性伺服器。

az postgres flexible-server list [--resource-group]

範例

列出訂用帳戶中的所有PostgreSQL彈性伺服器。

az postgres flexible-server list

列出資源群組中的所有PostgreSQL彈性伺服器。

az postgres flexible-server list --resource-group testGroup

以數據表格式列出資源群組中的所有 PostgreSQL 彈性伺服器。

az postgres flexible-server list --resource-group testGroup --output table

選擇性參數

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server list-skus

列出指定區域中可用的 SKU。

az postgres flexible-server list-skus --location

必要參數

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server restart

重新啟動彈性伺服器。

az postgres flexible-server restart [--failover]
                                    [--ids]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]

範例

重新啟動彈性伺服器。

az postgres flexible-server restart --resource-group testGroup --name testserver

重新啟動具有計劃性故障轉移的伺服器

az postgres flexible-server restart --resource-group testGroup --name testserver --failover Planned

使用強制故障轉移重新啟動伺服器

az postgres flexible-server restart --resource-group testGroup --name testserver --failover Forced

選擇性參數

--failover

伺服器重新啟動作業的強制或計劃性故障轉移。 允許的值：強制、已規劃。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server restore

從備份還原彈性伺服器。

az postgres flexible-server restore --source-server
                                    [--address-prefixes]
                                    [--backup-identity]
                                    [--backup-key]
                                    [--geo-redundant-backup {Disabled, Enabled}]
                                    [--identity]
                                    [--ids]
                                    [--key]
                                    [--name]
                                    [--no-wait]
                                    [--private-dns-zone]
                                    [--resource-group]
                                    [--restore-time]
                                    [--subnet]
                                    [--subnet-prefixes]
                                    [--subscription]
                                    [--vnet]
                                    [--yes]
                                    [--zone]

範例

將 『testserver』 還原至特定時間點作為新的伺服器 『testserverNew』。

az postgres flexible-server restore --resource-group testGroup --name testserverNew --source-server testserver --restore-time "2017-06-15T13:10:00Z"

將 『testserver』 還原至目前的時間點作為新的伺服器 『testserverNew』。

az postgres flexible-server restore --resource-group testGroup --name testserverNew --source-server testserver

將 'testerver' 還原至目前的時間點，作為不同資源群組中的新伺服器 'testerverNew'。 \ Here --restore-group 適用於目標伺服器的資源群組，而 --source-server 必須以資源標識符的形式傳遞。

az postgres flexible-server restore --resource-group testGroup --name testserverNew \
  --source-server /subscriptions/{testSubscription}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName}

將 'testerver' 還原至目前的時間點，作為不同訂用帳戶中的新伺服器 'testserverNew'。 \ Here --restore-group 適用於目標伺服器的資源群組，而 --source-server 必須以資源標識符的形式傳遞。 \ 此資源識別碼可以位於不同於 az account set 所用訂用帳戶的訂用帳戶中。

az postgres flexible-server restore --resource-group testGroup --name testserverNew \
  --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName}

必要參數

--source-server

要從中還原的來源伺服器名稱或資源標識碼。

選擇性參數

--address-prefixes

以 CIDR 格式建立新虛擬網路時要使用的 IP 位址前置碼。 預設值為 10.0.0.0/16。

--backup-identity

數據加密之異地備份使用者身分識別的名稱或資源識別碼。 身分識別必須位於與備份區域相同的區域中。

--backup-key

用於數據加密之異地備份密鑰保存庫金鑰的資源識別碼。 金鑰必須位於與備份區域相同的區域中。

--geo-redundant-backup

是否啟用異地備援備份。

接受的值: Disabled, Enabled

預設值: Disabled

--identity

用於數據加密之使用者指派身分識別的名稱或資源識別碼。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--key

數據加密之主要金鑰保存庫金鑰的資源識別碼。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--private-dns-zone

此參數僅適用於具有私人存取權的伺服器。 新或現有私人 DNS 區域的名稱或標識碼。 您可以使用來自相同資源群組、不同資源群組或不同訂用帳戶的私人 DNS 區域。 如果您想要使用來自不同資源群組或訂用帳戶的區域，請提供資源識別碼。如果使用者未提供，CLI 會在與虛擬網路相同的資源群組內建立新的私人 DNS 區域。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--restore-time

從UTC還原的時間點（ISO8601格式），例如2017-04-26T02：10：00+00：00預設值會設定為目前時間。

預設值: 2024-04-22T03:40:34+00:00

--subnet

新或現有子網的名稱或資源標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的子網，請提供資源識別碼，而不是名稱。 請注意，子網將會委派給彈性伺服器。 委派之後，此子網無法用於任何其他類型的 Azure 資源。

--subnet-prefixes

以 CIDR 格式建立新子網時要使用的子網 IP 位址前綴。 預設值為 10.0.0.0/24。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--vnet

新或現有虛擬網路的名稱或標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的 vnet，請提供資源識別碼。 名稱必須介於 2 到 64 個字元之間。 名稱的開頭必須是字母或數位、以字母、數位或底線結尾，而且只能包含字母、數位、底線、句號或連字元。

--yes -y

不提示確認。

預設值: False

--zone -z

要在其中布建資源的可用性區域。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server revive-dropped

從備份中恢復已卸除的彈性伺服器。

az postgres flexible-server revive-dropped --location
                                           --source-server
                                           [--address-prefixes]
                                           [--backup-identity]
                                           [--backup-key]
                                           [--geo-redundant-backup {Disabled, Enabled}]
                                           [--identity]
                                           [--ids]
                                           [--key]
                                           [--name]
                                           [--no-wait]
                                           [--private-dns-zone]
                                           [--resource-group]
                                           [--subnet]
                                           [--subnet-prefixes]
                                           [--subscription]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

範例

在具有公用存取權的位置 『newLocation』 中，將公用存取伺服器 『testerver』 恢復至新的伺服器 『testerverNew』。

az postgres flexible-server revive-dropped --resource-group testGroup --name testserverNew --source-server /subscriptions/{SubId}/resourceGroups/{testGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/testserver --location newLocation

恢復已卸除的公用存取伺服器 『testerver』，並啟用數據加密作為具有數據加密的新伺服器 『testerverNew』。

az postgres flexible-server revive-dropped -l testLocation --resource-group testGroup --name testserverNew \
  --source-server testserver --key newKeyIdentifier --identity newIdentity

必要參數

--location -l

位置。​​ 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--source-server

要從中還原的來源伺服器名稱或資源標識碼。

選擇性參數

--address-prefixes

以 CIDR 格式建立新虛擬網路時要使用的 IP 位址前置碼。 預設值為 10.0.0.0/16。

--backup-identity

數據加密之異地備份使用者身分識別的名稱或資源識別碼。 身分識別必須位於與備份區域相同的區域中。

--backup-key

用於數據加密之異地備份密鑰保存庫金鑰的資源識別碼。 金鑰必須位於與備份區域相同的區域中。

--geo-redundant-backup

是否啟用異地備援備份。

接受的值: Disabled, Enabled

預設值: Disabled

--identity

用於數據加密之使用者指派身分識別的名稱或資源識別碼。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--key

數據加密之主要金鑰保存庫金鑰的資源識別碼。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--private-dns-zone

此參數僅適用於具有私人存取權的伺服器。 新或現有私人 DNS 區域的名稱或標識碼。 您可以使用來自相同資源群組、不同資源群組或不同訂用帳戶的私人 DNS 區域。 如果您想要使用來自不同資源群組或訂用帳戶的區域，請提供資源識別碼。如果使用者未提供，CLI 會在與虛擬網路相同的資源群組內建立新的私人 DNS 區域。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subnet

新或現有子網的名稱或資源標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的子網，請提供資源識別碼，而不是名稱。 請注意，子網將會委派給彈性伺服器。 委派之後，此子網無法用於任何其他類型的 Azure 資源。

--subnet-prefixes

以 CIDR 格式建立新子網時要使用的子網 IP 位址前綴。 預設值為 10.0.0.0/24。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--vnet

新或現有虛擬網路的名稱或標識碼。 如果您想要使用來自不同資源群組或訂用帳戶的 vnet，請提供資源識別碼。 名稱必須介於 2 到 64 個字元之間。 名稱的開頭必須是字母或數位、以字母、數位或底線結尾，而且只能包含字母、數位、底線、句號或連字元。

--yes -y

不提示確認。

預設值: False

--zone -z

要在其中布建資源的可用性區域。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server show

取得彈性伺服器的詳細數據。

az postgres flexible-server show [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

範例

取得彈性伺服器的詳細數據

az postgres flexible-server show --resource-group testGroup --name testserver

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server show-connection-string

顯示 PostgreSQL 彈性伺服器資料庫的 連接字串。

az postgres flexible-server show-connection-string [--admin-password]
                                                   [--admin-user]
                                                   [--database-name]
                                                   [--ids]
                                                   [--pg-bouncer]
                                                   [--server-name]
                                                   [--subscription]

範例

顯示 cmd 和程式設計語言的 連接字串。

az postgres flexible-server show-connection-string -s testserver -u username -p password -d databasename

針對已啟用 PgBouncer 的 Cmd 和程式設計語言顯示 連接字串。

az postgres flexible-server show-connection-string -s testserver -u username -p password -d databasename --pg-bouncer

選擇性參數

--admin-password -p

系統管理員的密碼。 最少8個字元，最多128個字元。 密碼必須包含下列三個類別的字元：英文大寫字母、英文小寫字母、數位和非英數位元。

預設值: {password}

--admin-user -u

管理員 伺服器的用戶名稱。 設定之後，就無法變更。

預設值: {login}

--database-name -d

布建資料庫伺服器時要建立的資料庫名稱。

預設值: {database}

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--pg-bouncer

顯示 PgBouncer 的 連接字串。

預設值: False

--server-name -s

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

預設值: {server}

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server start

啟動彈性伺服器。

az postgres flexible-server start [--ids]
                                  [--name]
                                  [--no-wait]
                                  [--resource-group]
                                  [--subscription]

範例

啟動彈性伺服器。

az postgres flexible-server start --resource-group testGroup --name testserver

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server stop

停止彈性伺服器。

az postgres flexible-server stop [--ids]
                                 [--name]
                                 [--no-wait]
                                 [--resource-group]
                                 [--subscription]

範例

停止彈性伺服器。

az postgres flexible-server stop --resource-group testGroup --name testserver

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server update

更新彈性伺服器。

az postgres flexible-server update [--active-directory-auth {Disabled, Enabled}]
                                   [--add]
                                   [--admin-password]
                                   [--backup-identity]
                                   [--backup-key]
                                   [--backup-retention]
                                   [--force-string]
                                   [--high-availability {Disabled, SameZone, ZoneRedundant}]
                                   [--identity]
                                   [--ids]
                                   [--iops]
                                   [--key]
                                   [--maintenance-window]
                                   [--name]
                                   [--password-auth {Disabled, Enabled}]
                                   [--performance-tier]
                                   [--private-dns-zone]
                                   [--remove]
                                   [--resource-group]
                                   [--set]
                                   [--sku-name]
                                   [--standby-zone]
                                   [--storage-auto-grow {Disabled, Enabled}]
                                   [--storage-size]
                                   [--subscription]
                                   [--tags]
                                   [--throughput]
                                   [--tier]
                                   [--yes]

範例

使用伺服器和資源群組的本機內容來更新彈性伺服器的 SKU。

az postgres flexible-server update --sku-name Standard_D4s_v3

更新伺服器的標籤。

az postgres flexible-server update --resource-group testGroup --name testserver --tags "k1=v1" "k2=v2"

重設密碼

az postgres flexible-server update --resource-group testGroup --name testserver -p password123

更新彈性伺服器，以啟用已啟用密碼驗證伺服器的 Active Directory 驗證

az postgres flexible-server update --resource-group testGroup --name testserver --active-directory-auth Enabled

變更數據加密的金鑰/身分識別。 數據加密無法在伺服器建立后啟用，這隻會更新金鑰/身分識別。

# get key identifier of the existing key
newKeyIdentifier=$(az keyvault key show --vault-name testVault --name testKey \
  --query key.kid -o tsv)


# update server with new key/identity
az postgres flexible-server update --resource-group testGroup --name testserver \
  --key $newKeyIdentifier --identity newIdentity

更新彈性伺服器，以使用相同資源群組和訂用帳戶中的私人 DNS 區域，更新已啟用 VNET 之伺服器的私人 DNS 區域。 如果尚未連結，私用 DNS 區域將會建立 私用 DNS 區域會連結至 VNET。

az postgres flexible-server update --resource-group testGroup --name testserver --private-dns-zone testDNS2.postgres.database.azure.com

更新彈性伺服器，以使用不同資源群組和訂用帳戶中的私人 DNS 區域，更新已啟用 VNET 之伺服器的私人 DNS 區域。 如果尚未連結，私用 DNS 區域將會連結至 VNET。

az postgres flexible-server update --resource-group testGroup --name testserver --private-dns-zone /subscriptions/{SubId2}/resourceGroups/{testGroup2}/providers/Microsoft.Network/privateDnsZones/testDNS.postgres.database.azure.com

更新彈性伺服器的記憶體，以啟用/停用記憶體自動成長。

az postgres flexible-server update --resource-group testGroup --name testserver --storage-auto-grow Enabled

更新彈性伺服器的記憶體，以設定自定義記憶體效能層級。

az postgres flexible-server update --resource-group testGroup --name testserver --performance-tier P15

更新彈性伺服器的記憶體以設定 IOPS （operations/sec）。 伺服器必須使用 進階版 SSD v2 磁碟。

az postgres flexible-server update --resource-group testGroup --name testserver --iops 3000

更新彈性伺服器的記憶體以設定輸送量 （MB/秒）。 伺服器必須使用 進階版 SSD v2 磁碟。

az postgres flexible-server update --resource-group testGroup --name testserver --throughput 125

選擇性參數

--active-directory-auth

是否啟用 Azure Active Directory 驗證。

接受的值: Disabled, Enabled

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--admin-password -p

系統管理員的密碼。 最少8個字元，最多128個字元。 密碼必須包含下列三個類別的字元：英文大寫字母、英文小寫字母、數位和非英數位元。

--backup-identity

數據加密之異地備份使用者身分識別的名稱或資源識別碼。 身分識別必須位於與備份區域相同的區域中。

--backup-key

用於數據加密之異地備份密鑰保存庫金鑰的資源識別碼。 金鑰必須位於與備份區域相同的區域中。

--backup-retention

保留備份的天數。 範圍 7 到 35 天。 預設值為 7 天。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--high-availability

啟用 （ZoneRedundant 或 SameZone） 或停用高可用性功能。

接受的值: Disabled, SameZone, ZoneRedundant

--identity

用於數據加密之使用者指派身分識別的名稱或資源識別碼。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--iops

要配置給此伺服器的 IOPS 值（operations/sec）。 只有在彈性伺服器使用 進階版 SSD v2 磁碟時，才能更新此值。

--key

數據加密之主要金鑰保存庫金鑰的資源識別碼。

--maintenance-window

指定維護的期間（UTC）。 範例：「Sun：23：30」 以排程在星期日，下午 11：30 UTC。 若要將 設定為預設傳入 「Disabled」。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--password-auth

是否啟用密碼驗證。

接受的值: Disabled, Enabled

--performance-tier

伺服器的效能層級。

--private-dns-zone

此參數僅適用於具有私人存取權的伺服器。 新或現有私人 DNS 區域的名稱或標識碼。 您可以使用來自相同資源群組、不同資源群組或不同訂用帳戶的私人 DNS 區域。 如果您想要使用來自不同資源群組或訂用帳戶的區域，請提供資源識別碼。如果使用者未提供，CLI 會在與虛擬網路相同的資源群組內建立新的私人 DNS 區域。

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []

--sku-name

計算 SKU 的名稱。 遵循Standard_{VM 名稱}的慣例。 範例：Standard_B1ms。

--standby-zone

啟用高可用性時，待命伺服器的可用性區域資訊。

--storage-auto-grow

啟用或停用記憶體的自動成長。 預設值為 Enabled。

接受的值: Disabled, Enabled

--storage-size

伺服器的儲存容量。 最小值為 32 GiB，最大值為 16 TiB。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--throughput

儲存體 伺服器的輸送量 ，以 MB/秒為單位。 只有在彈性伺服器使用 進階版 SSD v2 磁碟時，才能更新此值。

--tier

伺服器的計算層。 接受的值：高載、GeneralPurpose、MemoryOptimized。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server upgrade

升級彈性伺服器的主要版本。

az postgres flexible-server upgrade --version {12, 13, 14, 15}
                                    [--ids]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

範例

將伺服器 『testvr』 升級至 PostgreSQL 主要版本 14。

az postgres flexible-server upgrade -g testgroup -n testsvr -v 14

必要參數

--version -v

伺服器主要版本。

接受的值: 12, 13, 14, 15

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--yes -y

不提示確認。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az postgres flexible-server wait

等候彈性伺服器滿足特定條件。

az postgres flexible-server wait [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--ids]
                                 [--interval]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]
                                 [--timeout]
                                 [--updated]

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--interval

輪詢間隔以秒為單位。

預設值: 30

--name -n

伺服器的名稱。 名稱只能包含小寫字母、數字及連字號 (-) 字元。 最少 3 個字元，最多 63 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。