Skip to content

Commit 0b97696

Browse files
authored
Merge pull request #197421 from brianlehr/newbranch
more explict guidance on derivation of piprefixes
2 parents 585576f + 2316726 commit 0b97696

File tree

1 file changed

+14
-5
lines changed

1 file changed

+14
-5
lines changed

articles/virtual-network/ip-services/manage-custom-ip-address-prefix.md

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -32,18 +32,27 @@ For information on provisioning an IP address, see [Create a custom IP address p
3232

3333
When a custom IP prefix is in **Provisioned**, **Commissioning**, or **Commissioned** state, a linked public IP prefix can be created. Either as a subset of the custom IP prefix range or the entire range.
3434

35-
> [!NOTE]
36-
> A public IP prefix can be derived from a custom IP prefix in another subscription with the appropriate permissions.
37-
38-
:::image type="content" source="./media/manage-custom-ip-address-prefix/custom-public-ip-prefix.png" alt-text="Diagram of custom IP prefix showing derived public IP prefixes across multiple subscriptions.":::
39-
4035
Use the following CLI and PowerShell commands to create public IP prefixes with the `--custom-ip-prefix-name` (CLI) and `-CustomIpPrefix` (PowerShell) parameters that point to an existing custom IP prefix.
4136

4237
|Tool|Command|
4338
|---|---|
4439
|CLI|[az network public-ip prefix create](/cli/azure/network/public-ip/prefix#az_network_public_ip_prefix_create)|
4540
|PowerShell|[New-AzPublicIpPrefix](/powershell/module/az.network/new-azpublicipprefix)|
4641

42+
> [!NOTE]
43+
> A public IP prefix can be derived from a custom IP prefix in another subscription with the appropriate permissions using Azure PowerShell or Azure portal.
44+
45+
:::image type="content" source="./media/manage-custom-ip-address-prefix/custom-public-ip-prefix.png" alt-text="Diagram of custom IP prefix showing derived public IP prefixes across multiple subscriptions.":::
46+
47+
An example derivation of a public IP prefix from a custom IP prefix using PowerShell is shown below:
48+
49+
```azurepowershell-interactive
50+
Set-AzContext -Subscription xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
51+
$customprefix = Get-AzCustomIpPrefix -Name myBYOIPPrefix -ResourceGroupName myResourceGroup
52+
Set-AzContext -Subscription yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
53+
New-AzPublicIpPrefix -Name myPublicIpPrefix -ResourceGroupName myResourceGroup2 -Location eastus -PrefixLength 30 -CustomIpPrefix $customprefix
54+
```
55+
4756
Once created, the IPs in the child public IP prefix can be associated with resources like any other standard SKU static public IPs. To learn more about using IPs from a public IP prefix, including selection of a specific IP from the range, see [Create a static public IP address from a prefix](manage-public-ip-address-prefix.md#create-a-static-public-ip-address-from-a-prefix).
4857

4958
## Migration of active prefixes from outside Microsoft

0 commit comments

Comments
 (0)