Skip to content

Commit 2c5b3f8

Browse files
mbender-msmbender-ms
committed
Update to tabs + Acrolinx
1 parent c6f575f commit 2c5b3f8

File tree

4 files changed

+125
-181
lines changed

4 files changed

+125
-181
lines changed

‎articles/virtual-network/ip-services/public-ip-upgrade-cli.md

Lines changed: 0 additions & 80 deletions
This file was deleted.

‎articles/virtual-network/ip-services/public-ip-upgrade-portal.md

Lines changed: 124 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,56 @@
11
---
2-
title: 'Upgrade a public IP address - Azure portal'
3-
description: In this article, you learn how to upgrade a basic SKU public IP address using the Azure portal.
2+
title: 'Upgrade a public IP address'
3+
description: Learn to upgrade a basic SKU public IP address to a standard SKU ip address using the Azure portal, Azure CLI, or Azure PowerShell.
44
author: mbender-ms
55
ms.author: mbender
6-
ms.date: 08/24/2023
6+
ms.date: 11/25/2024
77
ms.service: azure-virtual-network
88
ms.subservice: ip-services
99
ms.topic: how-to
1010
ms.custom: template-how-to, engagement-fy23
1111
---
1212

13-
# Upgrade a public IP address using the Azure portal
13+
# Upgrade a public IP address using the Azure portal, Azure CLI, or Azure PowerShell
1414

1515
>[!Important]
1616
>On September 30, 2025, Basic SKU public IPs will be retired. For more information, see the [official announcement](https://azure.microsoft.com/updates/upgrade-to-standard-sku-public-ip-addresses-in-azure-by-30-september-2025-basic-sku-will-be-retired/). If you are currently using Basic SKU public IPs, make sure to upgrade to Standard SKU public IPs prior to the retirement date.
1717
1818
Azure public IP addresses are created with a SKU, either Basic or Standard. The SKU determines their functionality including allocation method, feature support, and resources they can be associated with.
1919

20-
In this article, you'll learn how to upgrade a static Basic SKU public IP address to Standard SKU in the Azure portal.
20+
In this article, you learn how to upgrade a static Basic SKU public IP address to Standard SKU in the Azure portal, Azure CLI, or Azure PowerShell.
2121

2222
## Prerequisites
2323

24-
* An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
25-
* A static basic SKU public IP address in your subscription. For more information, see [Create a basic SKU public IP address using the Azure portal](./create-public-ip-portal.md?tabs=option-1-create-public-ip-basic#create-a-basic-sku-public-ip-address).
24+
# [Azure portal](#tab/azureportal)
25+
26+
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
27+
- A static basic SKU public IP address in your subscription. For more information, see [Create a basic SKU public IP address using the Azure portal](./create-public-ip-portal.md?tabs=option-1-create-public-ip-basic#create-a-basic-sku-public-ip-address).
28+
29+
# [Azure CLI](#tab/azurecli/)
30+
31+
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
32+
- A **static** basic SKU public IP address in your subscription. For more information, see [Create a basic public IP address using the Azure CLI](./create-public-ip-cli.md?tabs=create-public-ip-basic%2Ccreate-public-ip-zonal%2Crouting-preference#create-public-ip).
33+
34+
[!INCLUDE [azure-cli-prepare-your-environment.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
35+
36+
- This tutorial requires version 2.0.28 or later of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.
37+
38+
# [Azure PowerShell](#tab/azurepowershell/)
39+
40+
- An Azure account with an active subscription. [Create one for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
41+
- A **static** basic SKU public IP address in your subscription. For more information, see [Create a basic public IP address using PowerShell](./create-public-ip-powershell.md?tabs=create-public-ip-basic%2Ccreate-public-ip-non-zonal%2Crouting-preference#create-public-ip).
42+
- Access to Azure PowerShell installed locally or Azure Cloud Shell.
43+
- If you choose to install and use PowerShell locally, this article requires the Azure PowerShell module version 5.4.1 or later. Run `Get-Module -ListAvailable Az` to find the installed version. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-azure-powershell). If you're running PowerShell locally, you also need to run `Connect-AzAccount` to create a connection with Azure.
44+
45+
---
2646

2747
## Upgrade public IP address
2848

29-
In this section, you'll sign in to the Azure portal and upgrade your static Basic SKU public IP to the Standard sku.
49+
In this section, you upgrade your static Basic SKU public IP to the Standard SKU using the Azure portal, Azure CLI, or Azure PowerShell.
50+
51+
# [Azure portal](#tab/azureportal)
52+
53+
In this section, you sign in to the Azure portal and upgrade your static Basic SKU public IP to the Standard sku.
3054

3155
In order to upgrade a public IP, it must not be associated with any resource. For more information, see [View, modify settings for, or delete a public IP address](./virtual-network-public-ip-address.md#view-modify-settings-for-or-delete-a-public-ip-address) to learn how to disassociate a public IP.
3256

@@ -58,9 +82,69 @@ Upgrading a public IP resource retains the IP address.
5882
> [!WARNING]
5983
> Upgrading a basic public IP to standard SKU can't be reversed. Public IPs upgraded from basic to standard SKU continue to have no guaranteed [availability zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json).
6084
85+
# [Azure CLI](#tab/azurecli/)
86+
87+
In order to upgrade a public IP, it must not be associated with any resource. For more information, see [View, modify settings for, or delete a public IP address](./virtual-network-public-ip-address.md#view-modify-settings-for-or-delete-a-public-ip-address) to learn how to disassociate a public IP.
88+
89+
Upgrading a public IP resource retains the IP address.
90+
91+
>[!IMPORTANT]
92+
>In the majority of cases, Public IPs upgraded from Basic to Standard SKU continue to have no [availability zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json). This means they cannot be associated with an Azure resource that is either zone-redundant or tied to a pre-specified zone in regions where this is offered. (In rare cases where the Basic Public IP has a specific zone assigned, it will retain this zone when upgraded to Standard.)
93+
94+
> [!NOTE]
95+
> If you have multiple basic SKU public IP addresses attached to a virtual machine, it may be easier to use our [upgrade script](public-ip-upgrade-vm.md).
96+
97+
```azurecli-interactive
98+
az network public-ip update \
99+
--resource-group myResourceGroup \
100+
--name myBasicPublicIP \
101+
--sku Standard
102+
103+
```
104+
> [!NOTE]
105+
> The basic public IP you are upgrading must have static assignment. You'll receive a warning that the IP can't be upgraded if you try to upgrade a dynamically allocated IP address. Change the IP address assignment to static before upgrading.
106+
107+
> [!WARNING]
108+
> Upgrading a basic public IP to standard SKU can't be reversed. Public IPs upgraded from basic to standard SKU continue to have no guaranteed [availability zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json).
109+
110+
# [Azure PowerShell](#tab/azurepowershell/)
111+
112+
In order to upgrade a public IP, it must not be associated with any resource. For more information, see [View, modify settings for, or delete a public IP address](./virtual-network-public-ip-address.md#view-modify-settings-for-or-delete-a-public-ip-address) to learn how to disassociate a public IP.
113+
114+
Upgrading a public IP resource retains the IP address.
115+
116+
>[!IMPORTANT]
117+
>In the majority of cases, Public IPs upgraded from Basic to Standard SKU continue to have no [availability zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json). This means they cannot be associated with an Azure resource that is either zone-redundant or tied to a pre-specified zone in regions where this is offered. (In rare cases where the Basic Public IP has a specific zone assigned, it will retain this zone when upgraded to Standard.)
118+
119+
> [!NOTE]
120+
> If you have multiple basic SKU public IP addresses attached to a virtual machine, it may be easier to use our [upgrade script](public-ip-upgrade-vm.md).
121+
122+
```azurepowershell-interactive
123+
### Place the public IP address into a variable. ###
124+
$ip = @{
125+
Name = 'myBasicPublicIP'
126+
ResourceGroupName = 'myResourceGroup'
127+
}
128+
$pubIP = Get-AzPublicIpAddress @ip
129+
130+
### Set the SKU to standard. ###
131+
$pubIP.Sku.Name = 'Standard'
132+
Set-AzPublicIpAddress -PublicIpAddress $pubIP
133+
134+
```
135+
> [!NOTE]
136+
> The basic public IP you are upgrading must have static assignment. You'll receive a warning that the IP can't be upgraded if you try to upgrade a dynamically allocated IP address. Change the IP address assignment to static before upgrading.
137+
138+
> [!WARNING]
139+
> Upgrading a basic public IP to standard SKU can't be reversed. Public IPs upgraded from basic to standard SKU continue to have no guaranteed [availability zones](../../reliability/availability-zones-overview.md).
140+
141+
---
142+
61143
## Verify upgrade
62144

63-
In this section, you'll verify the public IP address is now the standard sku.
145+
In this section, you verify the public IP address is now the standard SKU using the Azure portal, Azure CLI, or Azure PowerShell.
146+
147+
# [Azure portal](#tab/azureportal)
64148

65149
1. Sign in to the [Azure portal](https://portal.azure.com).
66150

@@ -74,6 +158,37 @@ In this section, you'll verify the public IP address is now the standard sku.
74158

75159
:::image type="content" source="./media/public-ip-upgrade-portal/verify-upgrade-ip.png" alt-text="Screenshot showing public IP address is standard SKU." border="true":::
76160

161+
# [Azure CLI](#tab/azurecli/)
162+
163+
```azurecli-interactive
164+
# Get the SKU of the public IP address.
165+
az network public-ip show \
166+
--resource-group myResourceGroup \
167+
--name myBasicPublicIP \
168+
--query sku \
169+
--output tsv
170+
```
171+
> [NOTE!]
172+
> The command should display **Standard**.
173+
174+
# [Azure PowerShell](#tab/azurepowershell)
175+
176+
```azurepowershell-interactive
177+
### Place the public IP address into a variable. ###
178+
$ip = @{
179+
Name = 'myBasicPublicIP'
180+
ResourceGroupName = 'myResourceGroup'
181+
}
182+
$pubIP = Get-AzPublicIpAddress @ip
183+
184+
### Display setting. ####
185+
$pubIP.Sku.Name
186+
```
187+
> [NOTE!]
188+
> The command should display **Standard**.
189+
190+
---
191+
77192
## Next steps
78193

79194
In this article, you upgraded a basic SKU public IP address to standard SKU.

‎articles/virtual-network/ip-services/public-ip-upgrade-powershell.md

Lines changed: 0 additions & 87 deletions
This file was deleted.

‎articles/virtual-network/ip-services/toc.yml

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -98,12 +98,8 @@ items:
9898
items:
9999
- name: Upgrade guidance for Basic SKU public IP addresses
100100
href: public-ip-basic-upgrade-guidance.md
101-
- name: Upgrade a public IP address - Portal
101+
- name: Upgrade a public IP address
102102
href: public-ip-upgrade-portal.md
103-
- name: Upgrade a public IP address - PowerShell
104-
href: public-ip-upgrade-powershell.md
105-
- name: Upgrade a public IP address - Azure CLI
106-
href: public-ip-upgrade-cli.md
107103
- name: Migrate a classic reserved IP
108104
href: public-ip-upgrade-classic.md
109105
- name: Virtual machines

0 commit comments

Comments
 (0)