Skip to content

Commit 61cd064

Browse files
authored
Merge pull request #231564 from MicrosoftDocs/release-ga-virtual-network-manager
Release ga virtual network manager--scheduled release at 10am of 3/22
2 parents c8605dd + 32dc562 commit 61cd064

33 files changed

+483
-457
lines changed

articles/virtual-network-manager/TOC.yml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -61,18 +61,18 @@
6161
href: how-to-block-high-risk-ports.md
6262
- name: Create a network topology
6363
items:
64-
- name: Mesh
65-
items:
66-
- name: Azure portal
67-
href: how-to-create-mesh-network.md
68-
- name: Azure PowerShell
69-
href: how-to-create-mesh-network-powershell.md
7064
- name: Hub-and-spoke
7165
items:
7266
- name: Azure portal
7367
href: how-to-create-hub-and-spoke.md
7468
- name: Azure PowerShell
7569
href: how-to-create-hub-and-spoke-powershell.md
70+
- name: Mesh
71+
items:
72+
- name: Azure portal
73+
href: how-to-create-mesh-network.md
74+
- name: Azure PowerShell
75+
href: how-to-create-mesh-network-powershell.md
7676
- name: Cross-tenant connection support
7777
items:
7878
- name: Configure cross-tenant connection - Portal

articles/virtual-network-manager/common-issues.md

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,32 @@
11
---
2-
title: 'Common issues seen with Azure Virtual Network Manager (Preview)'
2+
title: 'Common issues seen with Azure Virtual Network Manager'
33
description: Learn about common issues seen when using Azure Virtual Network Manager.
44
author: mbender-ms
55
ms.author: mbender
66
ms.service: virtual-network-manager
77
ms.topic: how-to
8-
ms.date: 11/02/2021
8+
ms.date: 3/22/2023
99
ms.custom: template-concept, ignite-fall-2021
1010
---
1111

12-
# Common issues seen with Azure Virtual Network Manager (Preview)
12+
# Common issues seen with Azure Virtual Network Manager
1313

14-
In this article, we'll cover common issues you may face when using Azure Virtual Network Manager and provide some possible solutions.
14+
In this article, we cover common issues you may face when using Azure Virtual Network Manager and provide some possible solutions.
15+
16+
> [!IMPORTANT]
17+
> Azure Virtual Network Manager is generally available for Virtual Network Manager and hub and spoke connectivity configurations.
18+
>
19+
> Mesh connectivity configurations and security admin rules remain in public preview.
20+
> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
21+
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
1522
1623
## Why isn't my configuration getting applied?
1724

1825
**Common reasons for configurations not being applied:**
1926

2027
* The configuration isn't deployed to the regions where virtual networks are located.
2128

22-
* You haven't deployed the configuration yet. You'll need to deploy the configuration to have it take effect.
29+
* You haven't deployed the configuration yet. You need to deploy the configuration to have it take effect.
2330

2431
* The configuration didn't have enough time to effect. The time it takes for the configuration to apply after you commit the configuration is around 15-20 minutes. When there's an update to your network group membership, it would take about 10 minutes for the changes to reflect.
2532

@@ -31,7 +38,7 @@ You need to deploy the new configuration after the configuration is modified.
3138

3239
**You'll need to consider the following items:**
3340

34-
* In a hub-and-spoke topology, if you enable the option to *use the hub as a gateway*, you'll need to have a gateway in the hub virtual network. Otherwise, the creation of the virtual network peering between the hub and the spoke virtual networks will fail.
41+
* In a hub-and-spoke topology, if you enable the option to *use the hub as a gateway*, you need to have a gateway in the hub virtual network. Otherwise, the creation of the virtual network peering between the hub and the spoke virtual networks fails.
3542

3643
* If you want to have members in the network group to communicate with each other across regions in a hub and spoke topology configuration, you need to enable the global mesh option.
3744

articles/virtual-network-manager/concept-azure-policy-integration.md

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,22 @@
11
---
2-
title: "Configuring Azure Policy with network groups in Azure Virtual Network Manager (Preview)"
2+
title: "Configuring Azure Policy with network groups in Azure Virtual Network Manager"
33
description: Learn about how to utilize Azure Policy to configure a high scale and dynamic network group used with Azure Virtual Network Manager.
44
author: mbender-ms
55
ms.author: mbender
66
ms.service: virtual-network-manager
77
ms.topic: conceptual
8-
ms.date: 08/22/2022
8+
ms.date: 3/22/2023
99
ms.custom: template-concept
1010
---
1111

12-
# Configuring Azure Policy with network groups in Azure Virtual Network Manager (Preview)
12+
# Configuring Azure Policy with network groups in Azure Virtual Network Manager
1313

14-
In this article, you'll learn how [Azure Policy](../governance/policy/overview.md) is used in Azure Virtual Network Manager to define dynamic network group membership. Dynamic network groups allow you to create scalable and dynamically adapting virtual network environments in your organization.
14+
In this article, you learn how [Azure Policy](../governance/policy/overview.md) is used in Azure Virtual Network Manager to define dynamic network group membership. Dynamic network groups allow you to create scalable and dynamically adapting virtual network environments in your organization.
1515

1616
> [!IMPORTANT]
17-
> Azure Virtual Network Manager is currently in public preview.
17+
> Azure Virtual Network Manager is generally available for Virtual Network Manager and hub and spoke connectivity configurations.
18+
>
19+
> Mesh connectivity configurations and security admin rules remain in public preview.
1820
> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
1921
> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
2022
@@ -30,7 +32,7 @@ Azure Policy evaluates resources in Azure by comparing the properties of those r
3032

3133
Creating and implementing a policy in Azure Policy begins with creating a policy definition resource. Every policy definition has conditions under which it's enforced, and a defined effect that takes place if the conditions are met.
3234

33-
With network groups, your policy definition includes your conditional expression for matching virtual networks meeting your criteria, and specifies the destination network group where any matching resources are placed. The `addToNetworkGroup` effect is used to accomplish this. The following is a sample of a policy rule definition with the `addToNetworkGroup` effect.
35+
With network groups, your policy definition includes your conditional expression for matching virtual networks meeting your criteria, and specifies the destination network group where any matching resources are placed. The `addToNetworkGroup` effect is used to accomplish this. Here's a sample of a policy rule definition with the `addToNetworkGroup` effect.
3436

3537
```json
3638

@@ -56,7 +58,7 @@ Learn more about [policy definition structure](../governance/policy/concepts/def
5658

5759
## Policy assignments
5860

59-
Similar to Virtual Network Manager configurations, policy definitions don't immediately take effect when you create them. To begin applying, you must create a Policy Assignment, which assigns a definition to evaluate at a given scope. Currently, all resource within the scope will be evaluated against the definition. This allows you to have a single reusable definition that you can assign at multiple places for more granular group membership control. Learn more information on the [Assignment Structure](../governance/policy/concepts/assignment-structure.md) for Azure Policy.
61+
Similar to Virtual Network Manager configurations, policy definitions don't immediately take effect when you create them. To begin applying, you must create a Policy Assignment, which assigns a definition to evaluate at a given scope. Currently, all resources within the scope are evaluated against the definition. This allows you to have a single reusable definition that you can assign at multiple places for more granular group membership control. Learn more information on the [Assignment Structure](../governance/policy/concepts/assignment-structure.md) for Azure Policy.
6062

6163
Policy definitions and assignment can be created through with API/PS/CLI or [Azure Policy Portal]().
6264

@@ -72,22 +74,29 @@ To set the needed permissions, users can be assigned built-in roles with [role-b
7274
- **Resource Policy Contributor** role at the target scope level.
7375

7476
For more granular role assignment, you can create [custom roles](../role-based-access-control/custom-roles-portal.md) using the `networkGroups/join/action` permission and `policy/write` permission.
77+
78+
Along with the required permissions, your subscriptions and management groups must be registered with the following resource providers:
79+
- `Microsoft.Network` is required to create virtual networks.
80+
- `Microsoft.PolicyInsights` is required to use Azure Policy.
81+
82+
To set register the needed providers, use [Register-AzResourceProvider](/powershell/module/az.resources/register-azresourceprovider) in Azure PowerShell or [az provider register](/cli/azure/provider) in Azure CLI.
83+
7584
## Helpful tips
7685

7786
### Type filtering
7887

79-
When configuring your policy definitions, it's recommended to always include a **type** condition to scope it to virtual networks. This will allow Policy to filter out non virtual network operations and improve the efficiency of your policy resources.
88+
When configuring your policy definitions, it's recommended to always include a **type** condition to scope it to virtual networks. This allows Policy to filter out non virtual network operations and improve the efficiency of your policy resources.
8089

8190
### Regional slicing
8291

83-
Policy resources are global, which means that any change will take effect on all resources under the assignment scope, regardless of region. If regional slicing and gradual rollout is a concern for you, it's recommended to also include a `where location in []` condition. Then, you can incrementally expand the locations list to gradually roll out the effect.
92+
Policy resources are global, which means that any change takes effect on all resources under the assignment scope, regardless of region. If regional slicing and gradual rollout is a concern for you, it's recommended to also include a `where location in []` condition. Then, you can incrementally expand the locations list to gradually roll out the effect.
8493

8594
### Assignment scoping
8695
If you're following management group best practices using [Azure management groups](../governance/management-groups/overview.md), it's likely you already have your resources organized in a hierarchy structure. Using assignments, you can assign the same definition to multiple distinct scopes within your hierarchy, allowing you to have higher granularity control of which resources are eligible for your network group
8796

8897
### Deleting an Azure Policy definition associated with a network group
8998

90-
You may come across instances where you no longer need an Azure Policy definition. This could be when a network group associated with a Policy is deleted, or you have a unused Policy no longer need. To delete the Policy, you need to delete the Policy association object and then delete the policy definition in [Azure Policy](../governance/policy/tutorials/create-custom-policy-definition.md#clean-up-resources). Once this has been completed, the definition cannot be reused or re-referenced by name when associating a new definition to a network group.
99+
You may come across instances where you no longer need an Azure Policy definition. This could be when a network group associated with a Policy is deleted, or you have an unused Policy that you no longer need. To delete the Policy, you need to delete the Policy association object, and then delete the policy definition in [Azure Policy](../governance/policy/tutorials/create-custom-policy-definition.md#clean-up-resources). Once this has been completed, the definition can't be reused or re-referenced by name when associating a new definition to a network group.
91100

92101
## Next steps
93102

0 commit comments

Comments
 (0)