Edit

Get-AzDelegation

  • Reference
Module:
Az.Network

Get a delegation (or all of the delegations) on a given subnet.

Syntax

Get-AzDelegation
   [-Name <String>]
   -Subnet <PSSubnet>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

The Get-AzDelegation cmdlet gets the named delegation from a subnet. If no delegation is named, it returns all of the delegations on the provided subnet.

Examples

1: Retrieving a specific delegation

$subnet = Get-AzVirtualNetwork -Name "myVNet" -ResourceGroupName "myResourceGroup" | Get-AzVirtualNetworkSubnetConfig -Name "mySubnet"
Get-AzDelegation -Name "myDelegation" -Subnet $subnet

ProvisioningState : Succeeded
ServiceName       : Microsoft.Sql/servers
Actions           : {}
Name              : myDelegation
Etag              : "thisisaguid"
Id                : /subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/myvnet/subnets/mySubnet/delegations/myDelegation

The first line retrieves the subnet of interest. The second line shows the delegation information for the delegation called "myDelegation."

2: Retrieving all subnet delegations

$subnet = Get-AzVirtualNetwork -Name "myVNet" -ResourceGroupName "myResourceGroup" | Get-AzVirtualNetworkSubnetConfig -Name "mySubnet"
$delegations = Get-AzDelegation -Subnet $subnet

The first line retrieves the subnet of interest. The second line stores a list of all of the delegations on mySubnet in the $delegations variable.

Parameters

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

The name of the delegation

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Subnet

The subnet

Type:PSSubnet
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Inputs

String

PSSubnet

Outputs

PSDelegation