Skip to content

Latest commit

 

History

History
164 lines (124 loc) · 5.28 KB

azure-nlb-management-v1.md

File metadata and controls

164 lines (124 loc) · 5.28 KB
title description ms.date monikerRange
AzureNLBManagement@1 - Azure Network Load Balancer v1 task
Connect or disconnect an Azure virtual machine's network interface to a Load Balancer's back end address pool.
05/14/2024
<=azure-pipelines

AzureNLBManagement@1 - Azure Network Load Balancer v1 task

:::moniker range="<=azure-pipelines"

Use this task to connect or disconnect an Azure virtual machine's network interface to a load balancer's back-end address pool.

[!INCLUDE workload-identity]

:::moniker-end

Syntax

:::moniker range=">=azure-pipelines-2019.1"

# Azure Network Load Balancer v1
# Connect or disconnect an Azure virtual machine's network interface to a Load Balancer's back end address pool.
- task: AzureNLBManagement@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription. 
    ResourceGroupName: # string. Required. Resource Group. 
    LoadBalancer: # string. Required. Load Balancer Name. 
    Action: # 'Disconnect' | 'Connect'. Required. Action.

:::moniker-end

:::moniker range="=azure-pipelines-2019"

# Azure Network Load Balancer v1
# Connect/Disconnect an Azure virtual machine's network interface to a Load Balancer's backend address pool.
- task: AzureNLBManagement@1
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure Subscription. 
    ResourceGroupName: # string. Required. Resource Group. 
    LoadBalancer: # string. Required. Load Balancer Name. 
    Action: # 'Disconnect' | 'Connect'. Required. Action.

:::moniker-end

Inputs

:::moniker range="<=azure-pipelines"

azureSubscription - Azure Subscription
Input alias: ConnectedServiceName. string. Required.

Specifies the Azure Resource Manager subscription for the deployment.


:::moniker-end

:::moniker range="<=azure-pipelines"

ResourceGroupName - Resource Group
string. Required.

Specifies the resource group name.


:::moniker-end

:::moniker range="<=azure-pipelines"

LoadBalancer - Load Balancer Name
string. Required.

Specifies or enters the load balancer's name.


:::moniker-end

:::moniker range="<=azure-pipelines"

Action - Action
string. Required. Allowed values: Disconnect (Disconnect Primary Network Interface), Connect (Connect Primary Network Interface).

The action you'd like to perform.

Disconnect: Removes the virtual machine’s primary network interface from the load balancer’s back-end pool so it stops receiving network traffic.

Connect: Adds the virtual machine’s primary network interface to load balancer back-end pool so it starts receiving network traffic based on the load balancing rules for the load balancer resource.


:::moniker-end

Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

:::moniker range="<=azure-pipelines"

None.

:::moniker-end

Remarks

Use this task to connect or disconnect an Azure virtual machine's network interface to a load balancer's address pool.

Requirements

:::moniker range="<=azure-pipelines"

Requirement Description
Pipeline types YAML, Classic build, Classic release
Runs on DeploymentGroup
Demands None
Capabilities This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions Any
Settable variables Any
Agent version 1.95.0 or greater
Task category Utility

:::moniker-end