Azure プライベート エンドポイントを管理する

Azure WebApp は、プライベート エンドポイント リソースの例として使用されます。 Get-AzPrivateLinkResource を使用して、GroupId 値と MemberName 値を確認します。

## Place the previously created webapp into a variable. ##
$webapp = 
Get-AzWebApp -ResourceGroupName myResourceGroup -Name myWebApp1979

$resource = 
Get-AzPrivateLinkResource -PrivateLinkResourceId $webapp.ID

次の例のような出力が表示されます。

Azure WebApp は、プライベート エンドポイント リソースの例として使用されます。 az network private-link-resource list を使用して、GroupId と MemberName を確認します。 パラメーター --type には、Private Link リソースの名前空間が必要です。 この例で使用している Web アプリでは、名前空間は Microsoft.Web/sites です。 Private Link リソースの名前空間を確認するには、「Azure サービス DNS ゾーンの構成」を参照してください。

az network private-link-resource list \
    --resource-group MyResourceGroup \
    --name myWebApp1979 \
    --type Microsoft.Web/sites

次の例のような出力が表示されます。

プライベート エンドポイントの作成時にネットワーク インターフェイスの名前を変更するには、-CustomNetworkInterfaceName パラメーターを使用します。 次の例では、Azure PowerShell コマンドを使用して、Azure Web アプリへのプライベート エンドポイントを作成します。 詳細については、「New-AzPrivateEndpoint」を参照してください。

## Place the previously created webapp into a variable. ##
$webapp = Get-AzWebApp -ResourceGroupName myResourceGroup -Name myWebApp1979

## Create the private endpoint connection. ## 
$pec = @{
    Name = 'myConnection'
    PrivateLinkServiceId = $webapp.ID
    GroupID = 'sites'
}
$privateEndpointConnection = New-AzPrivateLinkServiceConnection @pec

## Place the virtual network you created previously into a variable. ##
$vnet = Get-AzVirtualNetwork -ResourceGroupName 'myResourceGroup' -Name 'myVNet'

## Create the private endpoint. ##
$pe = @{
    ResourceGroupName = 'myResourceGroup'
    Name = 'myPrivateEndpoint'
    Location = 'eastus'
    Subnet = $vnet.Subnets[0]
    PrivateLinkServiceConnection = $privateEndpointConnection
    CustomNetworkInterfaceName = 'myPrivateEndpointNIC'
}
New-AzPrivateEndpoint @pe

プライベート エンドポイントの作成時にネットワーク インターフェイスの名前を変更するには、--nic-name パラメーターを使用します。 次の例では、Azure PowerShell コマンドを使用して、Azure Web アプリへのプライベート エンドポイントを作成します。 詳細については、「az network private-endpoint create」を参照してください。

id=$(az webapp list \
    --resource-group myResourceGroup \
    --query '[].[id]' \
    --output tsv)

az network private-endpoint create \
    --connection-name myConnection \
    --name myPrivateEndpoint \
    --private-connection-resource-id $id \
    --resource-group myResourceGroup \
    --subnet myBackendSubnet \
    --group-id sites \
    --nic-name myPrivateEndpointNIC \
    --vnet-name myVNet

次の PowerShell コマンドを使用して、プライベート エンドポイント接続を管理します。

Private Link の接続状態を取得する

Get-AzPrivateEndpointConnection を使用して、プライベート エンドポイント接続とその状態を取得します。

$get = @{
    Name = 'myPrivateLinkService'
    ResourceGroupName = 'myResourceGroup'
}
Get-AzPrivateEndpointConnection @get

プライベート エンドポイント接続を承認する

Approve-AzPrivateEndpointConnection を使用して、プライベート エンドポイント接続を承認します。

$approve = @{
    Name = 'myPrivateEndpointConnection'
    ServiceName = 'myPrivateLinkService'
    ResourceGroupName = 'myResourceGroup'
}
Approve-AzPrivateEndpointConnection @approve

プライベート エンドポイント接続を拒否する

Deny-AzPrivateEndpointConnectionを使用して、プライベート エンドポイント接続を拒否します。

$deny = @{
    Name = 'myPrivateEndpointConnection'
    ServiceName = 'myPrivateLinkService'
    ResourceGroupName = 'myResourceGroup'
}
Deny-AzPrivateEndpointConnection  @deny

プライベート エンドポイント接続を削除する

Approve-AzPrivateEndpointConnection を使用して、プライベート エンドポイント接続を削除します。

$remove = @{
    Name = 'myPrivateEndpointConnection'
    ServiceName = 'myPrivateLinkService'
    ResourceGroupName = 'myResourceGroup'
}
Remove-AzPrivateEndpointConnection @remove

次の Azure CLI コマンドを使用して、プライベート エンドポイント接続を管理します。

Private Link の接続状態を取得する

az network private-endpoint-connection show を使用して、プライベート エンドポイント接続とその状態を取得します。

  az network private-endpoint-connection show \
    --name myPrivateEndpointConnection \
    --resource-group myResourceGroup

プライベート エンドポイント接続を承認する

az network private-endpoint-connection approveを使用して、プライベート エンドポイント接続を承認します。

  az network private-endpoint-connection approve \
    --name myPrivateEndpointConnection  \
    --resource-group myResourceGroup

プライベート エンドポイント接続を拒否する

az network private-endpoint-connection reject を使用して、プライベート エンドポイント接続を拒否します。

  az network private-endpoint-connection reject \
    --name myPrivateEndpointConnection  \
    --resource-group myResourceGroup

プライベート エンドポイント接続を削除する

az network private-endpoint-connection delete を使用して、プライベート エンドポイント接続を削除します。

  az network private-endpoint-connection delete \
    --name myPrivateEndpointConnection \
    --resource-group myResourceGroup