customer-controlled-gateway-maintenance.md

title	titleSuffix	description	author	ms.service	ms.custom	ms.topic	ms.date	ms.author
Configure customer-controlled maintenance for your virtual network gateway	ExpressRoute	Learn how to configure customer-controlled maintenance for your gateways using the Azure portal, or PowerShell.	cherylmc	expressroute	devx-track-azurepowershell	how-to	11/01/2023	cherylmc

Configure customer-controlled gateway maintenance for ExpressRoute (Preview)

This article helps you configure customer-controlled maintenance windows for your ExpressRoute virtual network gateways. Learn how to schedule customer-controlled maintenance for your gateways using the Azure portal or PowerShell.

[!INCLUDE Overview]

For more information on limitations and frequently asked questions related to customer-controlled maintenance, see the ExpressRoute FAQ.

[!INCLUDE Preview rollout]

Azure portal steps

[!INCLUDE Portal steps]

Example:

:::image type="content" source="./media/customer-controlled-gateway-maintenance/select-resources.png" alt-text="Screenshot showing the select resources page." lightbox="./media/customer-controlled-gateway-maintenance/select-resources.png":::

[!INCLUDE View add remove]

Azure PowerShell steps

[!INCLUDE PowerShell steps] 6. Create the maintenance configuration assignment using the New-AzConfigurationAssignment cmdlet. The maintenance policy is applied to the resource within 24 hours.

New-AzConfigurationAssignment -ResourceGroupName <rgName> -ProviderName "Microsoft.Network" -ResourceType "<your resource's resource type per ARM. For example, expressRouteGateways or virtualNetworkGateways>" -ResourceName "<your resource's name>" -ConfigurationAssignmentName "<assignment name>" -ResourceId $serviceResource.Id -MaintenanceConfigurationId $config.Id -Location "<arm location of resource>"

To remove a configuration assignment

[!INCLUDE Remove assignment]

Next steps

For more information, see the ExpressRoute FAQ.