Remove-AzLoadBalancerBackendAddressPoolConfig
Removes a backend address pool configuration from a load balancer.
Note
This is the previous version of our documentation. Please consult the most recent version for up-to-date information.
Syntax
Remove-AzLoadBalancerBackendAddressPoolConfig
-LoadBalancer <PSLoadBalancer>
[-Name <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Remove-AzLoadBalancerBackendAddressPoolConfig cmdlet removes a backend address pool from a load balancer.
Examples
Example 1: Remove a backend address pool configuration from a load balancer
PS C:\>Get-AzLoadBalancer -Name "MyLoadBalancer" -ResourceGroupName "MyResourceGroup" | Remove-AzLoadBalancerBackendAddressPoolConfig -Name "BackendAddressPool02" | Set-AzLoadBalancer
This command gets the load balancer named MyLoadBalancer and passes it to Remove-AzLoadBalancerBackendAddressPoolConfig, which removes the BackendAddressPool02 configuration from MyLoadBalancer. Finally, the Set-AzLoadBalancer cmdlet updates MyLoadBalancer. Note that a backend address pool configuration must exist before you can delete it.
Parameters
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The credentials, account, tenant, and subscription used for communication with azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the load balancer that contains the backend address pool to remove.
| Type: | PSLoadBalancer |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Specifies the name of the backend address pool that this cmdlet removes.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |