Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 2316726

Browse files
committedMay 6, 2022
more explict guidance on derivation of piprefixes
1 parent 74b58d6 commit 2316726

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)
Please sign in to comment.