本文說明如何建立私有端點並限制 Azure 檔案共用的公開端點存取權。 針對傳統檔案共用 (Microsoft.Storage),您需設定儲存體帳戶。 對於使用 Microsoft.FileShares 建立的檔案共用,你可以設定每個檔案共用。 經典的檔案分享步驟同樣適用於 Azure 檔案同步 使用的儲存帳號。 關於 Azure 檔案同步 網路需求,請參見「配置 Azure 檔案同步 代理與防火牆設定」。
欲在私有端點與網路規則間選擇,請參閱 Azure 檔案儲存體 網路相關事項。
先決條件
- 本文假設您已建立 Azure 訂用帳戶。 如果您沒有訂用帳戶,請建立 免費帳戶。
- 你需要一個你想要連線的 Azure 檔案共用。 若要了解如何建立 Azure 檔案共用,請參閱 建立傳統檔案共用 或 使用 Microsoft.FileShares 建立 Azure 檔案共用。
- 如果您想要使用 Azure PowerShell,請安裝最新版本。 Microsoft.FileShares 範例需要 16.0.0 或更新版本。 此版本包含 Az.FileShare 模組。
- 如果您想要使用 Azure CLI,請安裝最新版本。 Microsoft.FileShares 範例需要
fileshare 擴充功能。 若要安裝它,請執行 az extension add --name fileshare。
建立私人端點
當你為檔案分享建立私人端點時,你會部署以下 Azure 資源:
-
私有端點:代表私有端點的 Azure 資源。 你可以把這個資源想像成目標資源與網路介面之間的連接器。
-
網路介面(NIC):在指定的虛擬網路及子網路中維護私有 IP 位址的網路介面。 這個資源與你部署虛擬機(VM)時部署的資源相同。 不過,私有端點並非指派給虛擬機,而是擁有它。
-
私有網域名稱系統(DNS)區域:這些步驟建立或重用一個連結到虛擬網路的 Azure 私有 DNS 區域,並為私有端點新增 A 紀錄。 你可以改用自己的 DNS 基礎設施,前提是客戶端能將檔案分享的主機名稱解析成私有端點的 IP 位址。
附註
在 Azure 公有雲中,兩個資源提供者都使用 private DNS 區域privatelink.file.core.windows.net。 它們的用戶端主機名稱不同;範例請參閱驗證連線能力。 對於其他 Azure 雲端的經典檔案分享,請使用該雲端的儲存端點後綴。
私有端點的建立流程會因你使用的是傳統檔案共享還是 Microsoft.FileShares 而略有不同。 對於傳統檔案共用,您需為包含這些檔案共用的儲存體帳戶建立私人端點。 對於使用 Microsoft.FileShares 建立的檔案共用,您需為檔案共用本身建立私人端點。
許多步驟對兩家資源提供者來說是相同的。 只有資源參考、群組 ID 和 DNS 記錄名稱不同,如下表所示。
|
傳統檔案共用 (Microsoft.Storage) |
檔案共用 (Microsoft.FileShares) |
|
私有端點目標 |
記憶體帳戶 |
檔案共用 |
|
資源指令檔 |
Get-AzStorageAccount |
Get-AzFileShare |
|
群組識別碼(子資源) |
file |
FileShare |
|
DNS A 記錄名稱 |
儲存體帳戶名稱 |
主機名稱前綴(例如, fs-xxxxxxxxxxxxxxxxx) |
前往您要建立私人端點的資源群組。 選擇 + 建立 並搜尋 「私人端點」。 選擇私有端點資源,然後選擇 建立。
巫師有好幾頁要完成。
在基本頁面上,選取私人端點的訂用帳戶、資源群組、名稱、網路介面名稱和區域。 私有端點必須與其虛擬網路處於同一區域。 然後選取 [下一步:資源]。
在資源頁面上,從資源類型的下拉式選單中選取Microsoft.Storage/storageAccounts。 在 資源區,選擇你想連接的特定儲存帳號。 對於 目標子資源,請選擇 file。 然後選取 [下一步:虛擬網路]。
在 資源 頁面上,從 資源類型 的下拉式選單中選取 Microsoft.FileShares/fileShares。 在 資源中,選擇你想連接的特定檔案分享。 目標子資源會自動填入FileShare。 然後選取 [下一步:虛擬網路]。
虛擬網路 頁面可讓您選取要新增私人端點的特定虛擬網路和子網路。 為新的私人端點選取動態或靜態 IP 位址配置。 如果你選擇靜態,還需要提供名稱和私人 IP 位址。 您也可以選擇性指定應用程式安全性群組。 完成後,選取 [下一步:DNS]。
DNS 頁面包含整合私人端點與私有 DNS 區域的資訊。 請確認訂閱和資源群組正確,然後選擇 「下一頁:標籤」。
您可以選擇性地套用標籤來分類您的資源,例如將 Environment 名稱和 Test 值套用到所有測試資源。 輸入任何名稱/值組,然後選擇 「下一頁:檢閱 + 建立」。
選取 [建立] 以建立私人端點。
若要建立私人端點,請先取得儲存體帳戶或檔案共用的參考,以及要新增私人端點的虛擬子網路。 請將以下程式碼中的佔位值替換成你自己的值。
取得儲存帳戶的參考資料:
$storageAccountResourceGroupName = "<storage-account-resource-group-name>"
$storageAccountName = "<storage-account-name>"
$storageAccountParams = @{
ResourceGroupName = $storageAccountResourceGroupName
Name = $storageAccountName
ErrorAction = "SilentlyContinue"
}
$storageAccount = Get-AzStorageAccount @storageAccountParams
if ($null -eq $storageAccount) {
$errorMessage = "Storage account $storageAccountName not found "
$errorMessage += "in resource group $storageAccountResourceGroupName."
Write-Error -Message $errorMessage -ErrorAction Stop
}
# Set common variables for private endpoint creation
$resourceGroupName = $storageAccountResourceGroupName
$privateLinkResourceId = $storageAccount.Id
$groupId = "file"
$dnsRecordName = $storageAccountName
取得檔案共用的參考:
$fileShareResourceGroupName = "<resource-group-name>"
$fileShareName = "<file-share-name>"
$fileShareParams = @{
ResourceGroupName = $fileShareResourceGroupName
ResourceName = $fileShareName
ErrorAction = "SilentlyContinue"
}
$fileShare = Get-AzFileShare @fileShareParams
if ($null -eq $fileShare) {
$errorMessage = "File share $fileShareName not found "
$errorMessage += "in resource group $fileShareResourceGroupName."
Write-Error -Message $errorMessage -ErrorAction Stop
}
# Extract hostName and hostNamePrefix for DNS record
$hostName = $fileShare.HostName
$hostNamePrefix = $hostName.Split('.')[0]
# Set common variables for private endpoint creation
$resourceGroupName = $fileShareResourceGroupName
$privateLinkResourceId = $fileShare.Id
$groupId = "FileShare"
$dnsRecordName = $hostNamePrefix
取得虛擬網路和子網的參考資料:
$virtualNetworkResourceGroupName = "<vnet-resource-group-name>"
$virtualNetworkName = "<vnet-name>"
$subnetName = "<vnet-subnet-name>"
# Get virtual network reference, and throw error if it doesn't exist
$virtualNetworkParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $virtualNetworkName
ErrorAction = "SilentlyContinue"
}
$virtualNetwork = Get-AzVirtualNetwork @virtualNetworkParams
if ($null -eq $virtualNetwork) {
$errorMessage = "Virtual network $virtualNetworkName not found "
$errorMessage += "in resource group $virtualNetworkResourceGroupName."
Write-Error -Message $errorMessage -ErrorAction Stop
}
# Get reference to virtual network subnet, and throw error if it doesn't exist
$subnet = $virtualNetwork |
Select-Object -ExpandProperty Subnets |
Where-Object { $_.Name -eq $subnetName }
if ($null -eq $subnet) {
$errorMessage = "Subnet $subnetName not found in virtual network $virtualNetworkName."
Write-Error -Message $errorMessage -ErrorAction Stop
}
要建立私人端點,必須建立私人連結服務連線。 私人連結服務連線是建立私人端點時的輸入項目。
# Disable private endpoint network policies
$subnet.PrivateEndpointNetworkPolicies = "Disabled"
$virtualNetwork = $virtualNetwork | Set-AzVirtualNetwork -ErrorAction Stop
# Create a private link service connection.
$connectionParams = @{
Name = "$dnsRecordName-Connection"
PrivateLinkServiceId = $privateLinkResourceId
GroupId = $groupId
ErrorAction = "Stop"
}
$privateEndpointConnection = New-AzPrivateLinkServiceConnection @connectionParams
# Create a new private endpoint.
$privateEndpointParams = @{
ResourceGroupName = $resourceGroupName
Name = "$dnsRecordName-PrivateEndpoint"
Location = $virtualNetwork.Location
Subnet = $subnet
PrivateLinkServiceConnection = $privateEndpointConnection
ErrorAction = "Stop"
}
$privateEndpoint = New-AzPrivateEndpoint @privateEndpointParams
將 Azure 私人 DNS 區域連結到虛擬網路,讓用戶端能將檔案分享的原始主機名稱解析成私人端點的 IP 位址。 以下指令使用已連結到虛擬網路的 DNS 區域。 如果未連結任何區域,則會使用虛擬網路資源群組中的區域 (或建立一個區域) 並加以連結。 這些步驟適用於兩個資源提供者。
# Get the host name suffix (core.windows.net for public cloud).
# Reading it from the context lets this script work in non-public Azure clouds.
$hostNameSuffix = Get-AzContext |
Select-Object -ExpandProperty Environment |
Select-Object -ExpandProperty StorageEndpointSuffix
# For public cloud, this generates the following DNS suffix:
# privatelink.file.core.windows.net.
$dnsZoneName = "privatelink.file.$hostNameSuffix"
# Find a DNS zone matching desired name attached to this virtual network.
$dnsZone = Get-AzPrivateDnsZone |
Where-Object { $_.Name -eq $dnsZoneName } |
Where-Object {
$dnsLinkParams = @{
ResourceGroupName = $_.ResourceGroupName
ZoneName = $_.Name
ErrorAction = "SilentlyContinue"
}
$privateDnsLink = Get-AzPrivateDnsVirtualNetworkLink @dnsLinkParams
$privateDnsLink.VirtualNetworkId -eq $virtualNetwork.Id
}
if ($null -eq $dnsZone) {
# No matching DNS zone attached to virtual network, so use the zone in the
# virtual network's resource group, or create one, and link it.
$dnsZoneParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $dnsZoneName
ErrorAction = "SilentlyContinue"
}
$dnsZone = Get-AzPrivateDnsZone @dnsZoneParams
if ($null -eq $dnsZone) {
$dnsZoneParams.ErrorAction = "Stop"
$dnsZone = New-AzPrivateDnsZone @dnsZoneParams
}
$dnsLinkParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
ZoneName = $dnsZoneName
Name = "$virtualNetworkName-DnsLink"
VirtualNetworkId = $virtualNetwork.Id
ErrorAction = "Stop"
}
$privateDnsLink = New-AzPrivateDnsVirtualNetworkLink @dnsLinkParams
}
現在您已有私有 DNS 區域的參考,請建立 A 記錄。
$privateEndpointIP = $privateEndpoint |
Select-Object -ExpandProperty NetworkInterfaces |
Select-Object @{
Name = "NetworkInterfaces"
Expression = { Get-AzNetworkInterface -ResourceId $_.Id }
} |
Select-Object -ExpandProperty NetworkInterfaces |
Select-Object -ExpandProperty IpConfigurations |
Select-Object -ExpandProperty PrivateIpAddress
$privateDnsRecordConfig = New-AzPrivateDnsRecordConfig -IPv4Address $privateEndpointIP
$dnsRecordParams = @{
ResourceGroupName = $dnsZone.ResourceGroupName
Name = $dnsRecordName
RecordType = "A"
ZoneName = $dnsZone.Name
Ttl = 600
PrivateDnsRecords = $privateDnsRecordConfig
ErrorAction = "Stop"
}
New-AzPrivateDnsRecordSet @dnsRecordParams | Out-Null
若要建立私人端點,請先取得儲存體帳戶或檔案共用的參考資料,以及要新增私人端點的虛擬網路子網路。 請將接下來步驟中的佔位值替換成你自己的值。
取得儲存帳戶的參考資料:
storageAccountResourceGroupName="<storage-account-resource-group-name>"
storageAccountName="<storage-account-name>"
# Get storage account ID
privateLinkResourceId=$(az storage account show \
--resource-group $storageAccountResourceGroupName \
--name $storageAccountName \
--query "id" --output tsv)
# Set common variables for private endpoint creation
resourceGroupName=$storageAccountResourceGroupName
groupId="file"
dnsRecordName=$storageAccountName
取得檔案共用的參考:
fileShareResourceGroupName="<resource-group-name>"
fileShareName="<file-share-name>"
# Get the file share resource ID and host name
privateLinkResourceId=$(az fileshare show \
--resource-group $fileShareResourceGroupName \
--name $fileShareName \
--query "id" --output tsv)
hostName=$(az fileshare show \
--resource-group $fileShareResourceGroupName \
--name $fileShareName \
--query "properties.hostName" --output tsv)
hostNamePrefix=$(echo $hostName | cut -d'.' -f1)
# Set common variables for private endpoint creation
resourceGroupName=$fileShareResourceGroupName
groupId="FileShare"
dnsRecordName=$hostNamePrefix
設定完共用變數後,剩下的步驟對兩個資源提供者都是相同的。 取得虛擬網路和子網的參考資料:
virtualNetworkResourceGroupName="<vnet-resource-group-name>"
virtualNetworkName="<vnet-name>"
subnetName="<vnet-subnet-name>"
virtualNetwork=$(az network vnet show \
--resource-group $virtualNetworkResourceGroupName \
--name $virtualNetworkName \
--query "id" --output tsv)
subnet=$(az network vnet subnet show \
--resource-group $virtualNetworkResourceGroupName \
--vnet-name $virtualNetworkName \
--name $subnetName \
--query "id" --output tsv)
要建立私有端點,請確保該子網的私有端點網路政策被禁用,然後用 az network private-endpoint create 建立該私有端點。
# Disable private endpoint network policies
az network vnet subnet update \
--ids $subnet \
--private-endpoint-network-policies Disabled \
--output none
# Get virtual network location
region=$(az network vnet show \
--ids $virtualNetwork \
--query "location" --output tsv)
# Create a private endpoint
privateEndpoint=$(az network private-endpoint create \
--resource-group $resourceGroupName \
--name "$dnsRecordName-PrivateEndpoint" \
--location $region \
--subnet $subnet \
--private-connection-resource-id $privateLinkResourceId \
--group-id $groupId \
--connection-name "$dnsRecordName-Connection" \
--query "id" --output tsv)
將 Azure 私人 DNS 區域連結到虛擬網路,讓用戶端能將檔案共用的原始主機名稱解析成私人端點的 IP 位址。 以下指令使用已連結到虛擬網路的區域。 如果未連結任何區域,則會使用虛擬網路資源群組中的區域 (或建立一個區域) 並加以連結。 這些步驟適用於兩個資源提供者。
# Get the desired storage account suffix (core.windows.net for public cloud).
# This is done so the script will work for non-public Azure clouds.
storageAccountSuffix=$(az cloud show \
--query "suffixes.storageEndpoint" --output tsv)
# For public cloud, this generates the DNS suffix:
# privatelink.file.core.windows.net.
dnsZoneName="privatelink.file.$storageAccountSuffix"
# Find a DNS zone matching the desired name attached to this virtual network.
possibleDnsZones=$(az network private-dns zone list \
--query "[?name == '$dnsZoneName'].id" \
--output tsv)
dnsZone=""
for possibleDnsZone in $possibleDnsZones
do
possibleResourceGroupName=$(az resource show \
--ids $possibleDnsZone \
--query "resourceGroup" --output tsv)
link=$(az network private-dns link vnet list \
--resource-group $possibleResourceGroupName \
--zone-name $dnsZoneName \
--query "[?virtualNetwork.id == '$virtualNetwork'].id" \
--output tsv)
if [ -n "$link" ]
then
dnsZoneResourceGroup=$possibleResourceGroupName
dnsZone=$possibleDnsZone
break
fi
done
if [ -z "$dnsZone" ]
then
# No matching DNS zone is linked to the virtual network. Use the zone in the
# virtual network's resource group if it exists, or create a new one.
dnsZone=$(az network private-dns zone list \
--resource-group $virtualNetworkResourceGroupName \
--query "[?name == '$dnsZoneName'].id" \
--output tsv)
if [ -z "$dnsZone" ]
then
dnsZone=$(az network private-dns zone create \
--resource-group $virtualNetworkResourceGroupName \
--name $dnsZoneName \
--query "id" --output tsv)
fi
az network private-dns link vnet create \
--resource-group $virtualNetworkResourceGroupName \
--zone-name $dnsZoneName \
--name "$virtualNetworkName-DnsLink" \
--virtual-network $virtualNetwork \
--registration-enabled false \
--output none
dnsZoneResourceGroup=$virtualNetworkResourceGroupName
fi
現在您已有私有 DNS 區域的參考,請建立 A 記錄。
privateEndpointNIC=$(az network private-endpoint show \
--ids $privateEndpoint \
--query "networkInterfaces[0].id" --output tsv)
privateEndpointIP=$(az network nic show \
--ids $privateEndpointNIC \
--query "ipConfigurations[0].privateIPAddress" --output tsv)
az network private-dns record-set a create \
--resource-group $dnsZoneResourceGroup \
--zone-name $dnsZoneName \
--name $dnsRecordName \
--output none
az network private-dns record-set a add-record \
--resource-group $dnsZoneResourceGroup \
--zone-name $dnsZoneName \
--record-set-name $dnsRecordName \
--ipv4-address $privateEndpointIP \
--output none
驗證連線能力
從虛擬網路中的用戶端,或是已將 DNS 設定為可解析私人端點的連線網路執行檢查。 關於資源提供者之間的差異,請參見 DNS 解析。 使用原始主機名稱掛接檔案共用,而不是 privatelink 名稱。
請在 Windows、Linux 或 macOS 上,使用 PowerShell、命令列或終端機執行以下 DNS 查詢。
請用適當的儲存帳號名稱替換 <storage-account-name> :
nslookup <storage-account-name>.file.core.windows.net
如果成功,你會看到類似以下的輸出,其中192.168.0.5是虛擬網路中私有端點的私有 IP 位址(Windows 的輸出)。
Server: UnKnown
Address: 10.2.4.4
Non-authoritative answer:
Name: storageaccount.privatelink.file.core.windows.net
Address: 192.168.0.5
Aliases: storageaccount.file.core.windows.net
使用檔案分享的主機名稱。 在檔案分享的 總覽 頁面,選擇 JSON 檢視。 在 properties 下,複製 hostName 的值。 格式看起來像 fs-xxxxxxxxxxxxxxxxx.xx.file.storage.azure.net。
nslookup <file-share-host-name>
如果成功,你會看到類似以下的輸出,其中192.168.0.5是虛擬網路中私有端點的私有 IP 位址(Windows 的輸出)。
Server: UnKnown
Address: 10.2.4.4
Non-authoritative answer:
Name: <hostNamePrefix>.privatelink.file.core.windows.net
Address: 192.168.0.5
Aliases: <hostNamePrefix>.<zone>.file.storage.azure.net
要驗證 DNS 解析,先用 Azure PowerShell 取得主機名稱,然後從虛擬網路中的用戶端查詢該主機名稱。
$storageAccountHostName = [System.Uri]::new($storageAccount.PrimaryEndpoints.File) |
Select-Object -ExpandProperty Host
$storageAccountHostName
在虛擬網路中的用戶端上,執行以下指令。 用前一步的主機名稱替換 <host-name> 。
Resolve-DnsName -Name "<host-name>"
如果成功,你會看到類似以下的輸出,其中 192.168.0.5 是虛擬網路中私有端點的私有 IP 位址。
Name Type TTL Section NameHost
---- ---- --- ------- --------
storageaccount.file.core.windows CNAME 60 Answer storageaccount.privatelink.file.core.windows.net
.net
Name : storageaccount.privatelink.file.core.windows.net
QueryType : A
TTL : 600
Section : Answer
IP4Address : 192.168.0.5
$fileShare.HostName
在虛擬網路中的用戶端上,執行以下指令。 將 <host-name> 取代為上一個步驟中的主機名稱。
Resolve-DnsName -Name "<host-name>"
如果成功,你會看到類似以下的輸出,其中 192.168.0.5 是虛擬網路中私有端點的私有 IP 位址。
Name Type TTL Section NameHost
---- ---- --- ------- --------
<hostNamePrefix>.<zone>.file.storage.azur CNAME 60 Answer <hostNamePrefix>.privatelink.file.core.windows.net
e.net
Name : <hostNamePrefix>.privatelink.file.core.windows.net
QueryType : A
TTL : 600
Section : Answer
IP4Address : 192.168.0.5
要驗證 DNS 解析,先使用 Azure CLI 取得主機名稱,然後從虛擬網路中的用戶端查詢該主機名稱。
httpEndpoint=$(az storage account show \
--resource-group $storageAccountResourceGroupName \
--name $storageAccountName \
--query "primaryEndpoints.file" --output tsv)
hostName=${httpEndpoint#https://}
hostName=${hostName%/}
echo $hostName
在虛擬網路中的用戶端上,執行以下指令。 用前一步的主機名稱替換 <host-name> 。
nslookup <host-name>
如果成功,你會看到類似以下的輸出,其中 192.168.0.5 是虛擬網路中私有端點的私有 IP 位址。
Server: 127.0.0.53
Address: 127.0.0.53#53
Non-authoritative answer:
storageaccount.file.core.windows.net canonical name = storageaccount.privatelink.file.core.windows.net.
Name: storageaccount.privatelink.file.core.windows.net
Address: 192.168.0.5
hostName=$(az fileshare show \
--resource-group $fileShareResourceGroupName \
--name $fileShareName \
--query "properties.hostName" --output tsv)
echo $hostName
在虛擬網路中的用戶端上,執行以下指令。 用前一步的主機名稱替換 <host-name> 。
nslookup <host-name>
如果成功,你會看到類似以下的輸出,其中 192.168.0.5 是虛擬網路中私有端點的私有 IP 位址。
Server: 127.0.0.53
Address: 127.0.0.53#53
Non-authoritative answer:
<hostNamePrefix>.<zone>.file.storage.azure.net canonical name = <hostNamePrefix>.privatelink.file.core.windows.net.
Name: <hostNamePrefix>.privatelink.file.core.windows.net
Address: 192.168.0.5
限制公用端點存取
你可以關閉公共網路存取,或在特定網路上保持啟用。 這些配置是分開的。 私有端點在任一配置下都能正常運作。
對於經典檔案分享,請在儲存帳號設定公開存取權限。 針對 Microsoft.FileShares,請在個別檔案分享中設定。
經典檔案分享也可以使用 網路安全邊界,但須受其通訊協定限制。 在強制執行模式中,界限會拒絕未獲指派 IP 位址之服務端點的流量。 用戶端必須使用私有端點或 標準服務端點。
關閉公共網路存取
當你停用公用網路存取時,用戶端無法透過公用端點連線,包括透過服務端點。 用戶端仍可透過私人端點連線。 這個設定不會限制用戶端的輸出流量。
附註
對於經典檔案分享,關閉公共網路存取後,現有的受信任服務與資源實例例外仍然有效。 如果你只需要透過私有端點存取,請檢視這些例外。 請參閱 Azure 服務的例外。
要停用經典檔案分享的公共網路存取,請依照以下步驟操作:
- 移至您想要限制對公用端點所有輸入存取的儲存體帳戶。
- 在服務選單中,在安全 + 網路中選擇網路。
- 在公用網路存取下,選取 [管理]。
- 選擇 停用,然後選擇 繼續。
- 選取 [儲存]。
到你想關閉公開存取的檔案分享頁面。 從服務功能表的 [設定] 底下,選取 [網路]。 對於 公共端點存取,請選取 停用,然後選取 儲存。
對於傳統檔案共用,請在儲存體帳戶上,將 -PublicNetworkAccess 設為 Disabled
# Use the storage account variables from the beginning of this article.
$publicNetworkAccessParams = @{
ResourceGroupName = $storageAccountResourceGroupName
Name = $storageAccountName
PublicNetworkAccess = "Disabled"
ErrorAction = "Stop"
}
Set-AzStorageAccount @publicNetworkAccessParams | Out-Null
在檔案共用上,將 -PublicNetworkAccess 設為 Disabled。
$fileShareResourceGroupName = "<resource-group-name>"
$fileShareName = "<file-share-name>"
$publicNetworkAccessParams = @{
ResourceGroupName = $fileShareResourceGroupName
ResourceName = $fileShareName
PublicNetworkAccess = "Disabled"
}
Update-AzFileShare @publicNetworkAccessParams
對於傳統檔案共用,請在儲存體帳戶上,將 --public-network-access 設為 Disabled
# This assumes $storageAccountResourceGroupName and $storageAccountName
# are still defined from the beginning of this article.
az storage account update \
--resource-group $storageAccountResourceGroupName \
--name $storageAccountName \
--public-network-access Disabled \
--output none
在檔案共用上,將 --public-network-access 設為 Disabled。
fileShareResourceGroupName="<resource-group-name>"
fileShareName="<file-share-name>"
az fileshare update \
--name $fileShareName \
--resource-group $fileShareResourceGroupName \
--public-network-access Disabled
限制對公共端點的存取僅限特定網路
若要允許來自特定子網的用戶端,請保持公共網路存取啟用,啟用該子網的服務端點,並將子網加入資源的網路規則中。 你可以使用服務端點,也可以不使用私有端點。 子網路可以存在於其他區域、訂用帳戶,以及 Microsoft Entra 租戶中。 若要從其他租戶新增子網路,請使用 PowerShell 或 Azure CLI。 如需考量事項,請參閱 虛擬網路規則。
對於 SMB 和 FileREST 存取,你也可以新增 IP 位址規則。 IP 位址規則不會授予 NFS 存取權限。 對於 NFS 存取,請使用虛擬網路規則。 如果儲存帳號位於網路安全邊界內,你可以改用 標準服務端點 。
PowerShell 和 CLI 範例假設已啟用公開網路存取。 Microsoft.FileShares 的例子也假設客戶端子網路已經有 Microsoft.Storage 服務端點。 要設定該端點,請參見 「在子網路啟用服務端點」。
對於經典檔案分享,請依照以下步驟限制公共端點只能使用特定網路。
- 移至您要將公用端點限制為僅供特定網路存取的儲存體帳戶。
- 在服務選單中,在安全 + 網路中選擇網路。
- 在公用網路存取下,選取 [管理]。
- 在 公共網路存取範圍中,選擇 「從所選網路啟用」,然後選擇 「儲存」。
- 在 資源設定:虛擬網路、IP 位址與例外中,選擇 管理。
- 在 虛擬網路下,選取新增虛擬網路>新增現有的虛擬網路。 選擇虛擬網路和子網路。 如果某個子網路沒有
Microsoft.Storage 服務端點,請選取 啟用,並等待作業完成。 然後選擇 新增。
- 對於 SMB 或 FileREST 存取,在 IPv4 位址中輸入你想要允許的公共 IP 位址或範圍。 IP 位址規則不會授予 NFS 存取權限。
- 若服務整合需要受信任的服務存取,則在例外中選擇允許受信任的 Microsoft 服務 存取此資源。
- 選取 [儲存]。
針對 Microsoft.FileShares,請依照下列步驟將公用端點限制為特定網路。
- 到你想限制公開存取的檔案分享頁面。
- 從服務功能表的 [設定] 底下,選取 [網路]。
- 確保將 公共端點存取 設為 啟用。
- 在 公共端點限制中,選擇 新增虛擬網路。 選擇虛擬網路和子網路。 如果某個子網路沒有
Microsoft.Storage 服務端點,請選擇 啟用,並等待操作完成。 然後選擇 新增。
- 選取 [儲存]。
對於經典檔案分享,請透過服務端點限制對儲存帳號公共端點的存取,僅限於特定的虛擬網路。 首先,收集儲存帳號和虛擬網路的資訊。 請將接下來步驟中的佔位值替換成你自己的值。
$storageAccountResourceGroupName = "<storage-account-resource-group>"
$storageAccountName = "<storage-account-name>"
$restrictToVirtualNetworkResourceGroupName = "<vnet-resource-group-name>"
$restrictToVirtualNetworkName = "<vnet-name>"
$subnetName = "<subnet-name>"
$storageAccountParams = @{
ResourceGroupName = $storageAccountResourceGroupName
Name = $storageAccountName
ErrorAction = "Stop"
}
$storageAccount = Get-AzStorageAccount @storageAccountParams
$virtualNetworkParams = @{
ResourceGroupName = $restrictToVirtualNetworkResourceGroupName
Name = $restrictToVirtualNetworkName
ErrorAction = "Stop"
}
$virtualNetwork = Get-AzVirtualNetwork @virtualNetworkParams
$subnet = $virtualNetwork |
Select-Object -ExpandProperty Subnets |
Where-Object { $_.Name -eq $subnetName }
if ($null -eq $subnet) {
$errorMessage = "Subnet $subnetName not found in virtual network $restrictToVirtualNetworkName."
Write-Error -Message $errorMessage -ErrorAction Stop
}
為了允許來自虛擬網路的流量,Azure 網路織體必須將Microsoft.Storage服務端點暴露給虛擬網路的子網。 以下 PowerShell 指令會將 Microsoft.Storage 服務端點加入子網,如果它還沒存在的話。
$serviceEndpoints = $subnet |
Select-Object -ExpandProperty ServiceEndpoints |
Select-Object -ExpandProperty Service
if ($serviceEndpoints -notcontains "Microsoft.Storage") {
# Change the subnet object directly so the subnet keeps its delegations
# and service endpoint policies.
$storageEndpointParams = @{
TypeName = "Microsoft.Azure.Commands.Network.Models.PSServiceEndpoint"
Property = @{ Service = "Microsoft.Storage" }
}
$storageEndpoint = New-Object @storageEndpointParams
$subnet.ServiceEndpoints = @($subnet.ServiceEndpoints | Where-Object { $_ }) + $storageEndpoint
$virtualNetwork = $virtualNetwork | Set-AzVirtualNetwork -ErrorAction Stop
}
限制流量到儲存帳號的最後一步是建立虛擬網路規則,並將其加入儲存帳號的網路規則集。
$networkRuleParams = @{
VirtualNetworkResourceId = $subnet.Id
ErrorAction = "Stop"
}
$networkRule = $storageAccount | Add-AzStorageAccountNetworkRule @networkRuleParams
$networkRuleSetParams = @{
DefaultAction = "Deny"
VirtualNetworkRule = $networkRule
WarningAction = "SilentlyContinue"
ErrorAction = "Stop"
}
$storageAccount | Update-AzStorageAccountNetworkRuleSet @networkRuleSetParams | Out-Null
這些指令保留現有的繞過設定。 如果整合需要受信任的服務存取權限,請在更新指令中加入 -Bypass AzureServices 。 此參數會取代略過設定,因此請一併包含工作負載仍需要的其他略過選項。
對於從網際網路存取 SMB 或 FileREST,你也可以允許公共 IP 位址或範圍。 IP 位址規則不適用於與儲存帳號同屬 Azure 區域的客戶端。 其他限制請參見 IP 位址規則。
$ipAddressOrRange = "<public-ip-address-or-cidr-range>"
$ipRuleParams = @{
ResourceGroupName = $storageAccountResourceGroupName
Name = $storageAccountName
IPAddressOrRange = $ipAddressOrRange
ErrorAction = "Stop"
}
Add-AzStorageAccountNetworkRule @ipRuleParams | Out-Null
使用 -AllowedSubnet 將允許的子網路資源識別碼傳遞給 Update-AzFileShare。 網路規則直接套用至檔案共用,因此沒有可供設定的儲存體帳戶。 用戶端子網必須已經包含 Microsoft.Storage 服務端點。
$fileShareResourceGroupName = "<resource-group-name>"
$fileShareName = "<file-share-name>"
$virtualNetworkResourceGroupName = "<vnet-resource-group-name>"
$virtualNetworkName = "<vnet-name>"
$subnetName = "<subnet-name>"
$virtualNetworkParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $virtualNetworkName
}
$subnet = Get-AzVirtualNetwork @virtualNetworkParams |
Select-Object -ExpandProperty Subnets |
Where-Object { $_.Name -eq $subnetName }
$allowedSubnetParams = @{
ResourceGroupName = $fileShareResourceGroupName
ResourceName = $fileShareName
AllowedSubnet = @($subnet.Id)
}
Update-AzFileShare @allowedSubnetParams
對於經典檔案分享,請透過服務端點限制對儲存帳號公共端點的存取,僅限於特定的虛擬網路。 首先,收集儲存帳號和虛擬網路的資訊。 請將接下來步驟中的佔位值替換成你自己的值。
storageAccountResourceGroupName="<storage-account-resource-group>"
storageAccountName="<storage-account-name>"
restrictToVirtualNetworkResourceGroupName="<vnet-resource-group-name>"
restrictToVirtualNetworkName="<vnet-name>"
subnetName="<subnet-name>"
storageAccount=$(az storage account show \
--resource-group $storageAccountResourceGroupName \
--name $storageAccountName \
--query "id" --output tsv)
virtualNetwork=$(az network vnet show \
--resource-group $restrictToVirtualNetworkResourceGroupName \
--name $restrictToVirtualNetworkName \
--query "id" --output tsv)
subnet=$(az network vnet subnet show \
--resource-group $restrictToVirtualNetworkResourceGroupName \
--vnet-name $restrictToVirtualNetworkName \
--name $subnetName \
--query "id" --output tsv)
為了允許來自虛擬網路的流量,Azure 網路織體必須將Microsoft.Storage服務端點暴露給虛擬網路的子網。 以下 CLI 指令會將 Microsoft.Storage 服務端點加入子網,如果它還沒存在的話。
serviceEndpoints=$(az network vnet subnet show \
--resource-group $restrictToVirtualNetworkResourceGroupName \
--vnet-name $restrictToVirtualNetworkName \
--name $subnetName \
--query "serviceEndpoints[].service" \
--output tsv)
foundStorageServiceEndpoint=false
for serviceEndpoint in $serviceEndpoints
do
if [ $serviceEndpoint = "Microsoft.Storage" ]
then
foundStorageServiceEndpoint=true
fi
done
if [ $foundStorageServiceEndpoint = false ]
then
serviceEndpointList=""
for serviceEndpoint in $serviceEndpoints
do
serviceEndpointList+=$serviceEndpoint
serviceEndpointList+=" "
done
serviceEndpointList+="Microsoft.Storage"
az network vnet subnet update \
--ids $subnet \
--service-endpoints $serviceEndpointList \
--output none
fi
限制流量到儲存帳號的最後一步是建立虛擬網路規則,並將其加入儲存帳號的網路規則集。
az storage account network-rule add \
--resource-group $storageAccountResourceGroupName \
--account-name $storageAccountName \
--subnet $subnet \
--output none
az storage account update \
--resource-group $storageAccountResourceGroupName \
--name $storageAccountName \
--default-action "Deny" \
--output none
這些指令保留現有的繞過設定。 如果整合需要受信任的服務存取權限,請在更新指令中加入 --bypass AzureServices 。 這個選項取代了繞過設定,所以請包含你的工作負載仍需要的其他繞過選項。
對於從網際網路存取 SMB 或 FileREST,你也可以允許公共 IP 位址或範圍。 IP 位址規則不適用於與儲存帳號同屬 Azure 區域的客戶端。 其他限制請參見 IP 位址規則。
ipAddressOrRange="<public-ip-address-or-cidr-range>"
az storage account network-rule add \
--resource-group $storageAccountResourceGroupName \
--account-name $storageAccountName \
--ip-address $ipAddressOrRange \
--output none
使用 --allowed-subnets 將允許的子網路資源識別碼傳遞給 az fileshare update。 網路規則直接套用至檔案共用,因此沒有可供設定的儲存體帳戶。 用戶端子網路必須已經包含 Microsoft.Storage 服務端點。
fileShareResourceGroupName="<resource-group-name>"
fileShareName="<file-share-name>"
virtualNetworkResourceGroupName="<vnet-resource-group-name>"
virtualNetworkName="<vnet-name>"
subnetName="<subnet-name>"
subnetId=$(az network vnet subnet show \
--resource-group $virtualNetworkResourceGroupName \
--vnet-name $virtualNetworkName \
--name $subnetName \
--query "id" --output tsv)
az fileshare update \
--name $fileShareName \
--resource-group $fileShareResourceGroupName \
--allowed-subnets $subnetId
允許從標準服務端點存取
透過使用 標準服務端點,位於子網路中的用戶端可以透過服務端點存取網路安全邊界內的儲存帳戶。 邊界設定檔中有一個入站存取規則,允許來自所有使用服務端點 IP 位址之子網路的流量。 此規則適用於 SMB、NFS 和 FileREST。
下列步驟會建立一個公用 IP 位址,將其指派給子網的 Microsoft.Storage 服務端點,並為該位址加入邊界設定檔的入站存取規則。
請記住以下幾點:
- 儲存體帳戶必須與網路安全性界限建立關聯。 要建立邊界並關聯儲存帳號,請參見快速入門:建立網路安全邊界 - Azure 入口網站。
- 子網路必須已經有
Microsoft.Storage 服務端點。 若要加以新增,請參閱將公用端點的存取權限制為特定網路。
- 公共 IP 位址必須使用標準 SKU、靜態配置和 IPv4。 它必須與虛擬網路在同一區域內。
- 你可以將相同的 IP 位址指派給同一區域內的其他子網路和虛擬網路,包括同一 Microsoft Entra 租戶中其他訂閱的虛擬網路。
- 子網路上的所有服務端點必須使用相同的 IP 位址。
- 指派或更改 IP 位址會重設來自該子網的作用中連線。 將變更安排在維護時段。
- 要為服務端點指派公共 IP 位址,你需要取得
Microsoft.Network/publicIPAddresses/joinServiceEndpointNetworkIdentifier/action 權限。 網路貢獻者角色包含此權限。
- 在界限關聯處於強制執行模式之前,允許該子網路的虛擬網路規則仍會繼續套用。
- 您也可以將 IP 位址新增至儲存體帳戶的 IP 位址規則,而不使用界限規則。 若沒有界限,搭配虛擬網路規則的基本服務端點即可提供相同的存取權,且不需額外費用。
若要允許標準服務端點存取,請依照以下步驟操作。 更多資訊請參閱「使用 Azure 入口網站設定標準服務端點」。
- 在 Azure 入口網站頂端的搜尋框中,輸入「公共 IP 位址」。 在搜尋結果中,選取 [公用 IP 位址]。
- 選擇 + 創建。
- 在 基礎 標籤中,選擇訂閱、資源群組及虛擬網路的區域。 輸入名稱。 對於 IP 版本,請選擇 IPv4。 對於 SKU,請選擇 標準。
- 選取 審核 + 建立,然後選取 建立。
- 部署完成後,前往新的公開 IP 位址。 複製 IP位址的值。
- 進入包含客戶端子網的虛擬網路。 在服務選單中,在 設定中選擇 子網路。 選取子網路。
- 在 服務端點下,針對網路識別碼訂用帳戶 ,選取公用 IP 位址的訂用帳戶。 對於 Network identifier,選擇你建立的公用 IP 位址。
- 在服務列表中,針對 Microsoft.Storage,選擇啟用網路識別碼。 選取 [儲存]。
- 前往儲存帳號所關聯的網路安全邊界。 在服務選單中,在 設定中選擇 設定檔。 選擇儲存體帳戶所關聯的設定檔。
- 在服務選單中,在 設定中選擇 入站存取規則。 選取 ,然後新增。
- 針對規則名稱,輸入名稱。 對於來源類型,請選擇 IP 位址範圍。 對於 允許來源,輸入你複製的 IP 位址,接著輸入
/32。 選取 ,然後新增。
以下 PowerShell 指令會建立一個公用 IP 位址,指派給子網的 Microsoft.Storage 服務端點,並為該位址加入邊界設定檔的入站存取規則。 用你自己的值替換佔位符值。
$virtualNetworkResourceGroupName = "<vnet-resource-group-name>"
$virtualNetworkName = "<vnet-name>"
$subnetName = "<subnet-name>"
$publicIpName = "<public-ip-name>"
$perimeterResourceGroupName = "<perimeter-resource-group-name>"
$perimeterName = "<perimeter-name>"
$profileName = "<profile-name>"
$accessRuleName = "<access-rule-name>"
$virtualNetworkParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $virtualNetworkName
ErrorAction = "Stop"
}
$virtualNetwork = Get-AzVirtualNetwork @virtualNetworkParams
$subnet = $virtualNetwork.Subnets | Where-Object { $_.Name -eq $subnetName }
if ($null -eq $subnet) {
throw "Subnet '$subnetName' wasn't found in virtual network '$virtualNetworkName'."
}
$storageEndpoint = $subnet.ServiceEndpoints | Where-Object { $_.Service -eq "Microsoft.Storage" }
if ($null -eq $storageEndpoint) {
throw "The subnet doesn't have the Microsoft.Storage service endpoint. Add it before you continue."
}
$publicIpParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $publicIpName
Location = $virtualNetwork.Location
Sku = "Standard"
AllocationMethod = "Static"
IpAddressVersion = "IPv4"
ErrorAction = "Stop"
}
$publicIp = New-AzPublicIpAddress @publicIpParams
$networkIdentifierParams = @{
TypeName = "Microsoft.Azure.Commands.Network.Models.PSResourceId"
Property = @{ Id = $publicIp.Id }
}
$storageEndpoint.NetworkIdentifier = New-Object @networkIdentifierParams
$virtualNetwork | Set-AzVirtualNetwork -ErrorAction Stop | Out-Null
$accessRuleParams = @{
ResourceGroupName = $perimeterResourceGroupName
SecurityPerimeterName = $perimeterName
ProfileName = $profileName
Name = $accessRuleName
Direction = "Inbound"
AddressPrefix = @("$($publicIp.IpAddress)/32")
ErrorAction = "Stop"
}
New-AzNetworkSecurityPerimeterAccessRule @accessRuleParams | Out-Null
以下 CLI 指令會建立公用 IP 位址、將其指派給子網路的 Microsoft.Storage 服務端點,並為該位址新增邊界設定檔的輸入存取規則。 用你自己的值替換佔位符值。 這些az network perimeter命令需要 Azure CLI 的 nsp 擴充功能。 若要安裝它,請執行 az extension add --name nsp。
virtualNetworkResourceGroupName="<vnet-resource-group-name>"
virtualNetworkName="<vnet-name>"
subnetName="<subnet-name>"
publicIpName="<public-ip-name>"
perimeterResourceGroupName="<perimeter-resource-group-name>"
perimeterName="<perimeter-name>"
profileName="<profile-name>"
accessRuleName="<access-rule-name>"
storageEndpointIndex=$(az network vnet subnet show \
--resource-group $virtualNetworkResourceGroupName \
--vnet-name $virtualNetworkName \
--name $subnetName \
--query "serviceEndpoints[].service" \
--output tsv | \
grep --line-number --line-regexp --fixed-strings "Microsoft.Storage" | \
cut -d ":" -f 1)
if [ -z "$storageEndpointIndex" ]; then
echo "The subnet doesn't have the Microsoft.Storage service endpoint. Add it before you continue." >&2
else
location=$(az network vnet show \
--resource-group $virtualNetworkResourceGroupName \
--name $virtualNetworkName \
--query "location" \
--output tsv) &&
az network public-ip create \
--resource-group $virtualNetworkResourceGroupName \
--name $publicIpName \
--location $location \
--sku Standard \
--allocation-method Static \
--version IPv4 \
--output none &&
publicIpId=$(az network public-ip show \
--resource-group $virtualNetworkResourceGroupName \
--name $publicIpName \
--query "id" \
--output tsv) &&
publicIpAddress=$(az network public-ip show \
--resource-group $virtualNetworkResourceGroupName \
--name $publicIpName \
--query "ipAddress" \
--output tsv) &&
az network vnet subnet update \
--resource-group $virtualNetworkResourceGroupName \
--vnet-name $virtualNetworkName \
--name $subnetName \
--set "serviceEndpoints[$((storageEndpointIndex - 1))].networkIdentifier={\"id\":\"$publicIpId\"}" \
--output none &&
az network perimeter profile access-rule create \
--resource-group $perimeterResourceGroupName \
--perimeter-name $perimeterName \
--profile-name $profileName \
--access-rule-name $accessRuleName \
--direction Inbound \
--address-prefixes "$publicIpAddress/32" \
--output none
fi
Microsoft.FileShares 不支援網路安全性界限。 如果具有標準服務端點的子網路位於檔案共用的允許子網路中,該子網路中的用戶端仍可存取 Microsoft.FileShares 檔案共用。 關於步驟,請參見 限制對公共端點的存取僅限特定網路。
限制對特定儲存體帳戶的對外存取
檔案共用的網路規則可控制輸入存取。 它們不限制客戶端能存取哪些其他儲存資源。 對於經典檔案分享,你可以使用 服務端點政策 來限制子網路中客戶端能透過服務端點存取哪些儲存帳號。 該原則會篩選會繞過 Azure 防火牆 和網路虛擬設備的流量目的地。 它不會限制其他出站路徑,也不會取代目的地的網路規則和授權要求。 欲了解更多資訊,請參閱 「以服務端點政策限制外出存取」。
Important
服務端點原則不支援 Microsoft.FileShares 檔案共用。 即使用戶端子網路的原則允許其訂用帳戶或資源群組,仍會封鎖透過服務端點存取這些檔案共用。 此限制同樣適用於同時存取經典與 Microsoft.FileShares 檔案共用的子網路。 該子網路中的用戶端必須使用私人端點才能存取 Microsoft.FileShares 檔案共用。
服務端點政策定義了用戶端在相關子網路中允許的儲存目的地。 它會阻止這些用戶端透過服務端點存取其他儲存帳號。 請記住以下幾點:
- 在將原則與子網路建立關聯之前,先新增該子網路中用戶端所使用的所有儲存體帳戶。 此清單包含子網路中其他工作負載使用的儲存帳號。
- 服務端點政策必須與虛擬網路位於相同的區域,且屬於相同的訂用帳戶。
- 一個政策對於
Microsoft.Storage 服務只能包含一個政策定義。 若要允許更多儲存帳號,請將它們的資源 ID 加入相同的政策定義。 你也可以允許資源群組或訂閱中的所有儲存帳號。
- 將原則與子網路建立關聯後,該原則便會套用至前往所有區域中儲存體帳戶的流量。
- 這些步驟假設子網路沒有服務端點政策。 如果政策已經被關聯,請檢視並更新這些政策,而不是替換它們的關聯。 PowerShell 和 CLI 範例如果找到已有關聯就會停止。
要建立服務端點政策並將其關聯到子網,請遵循以下步驟。 詳細步驟請參閱 建立與關聯服務端點政策。
- 在 Azure 入口網站頂端的搜尋框中,輸入 Service endpoint policy。 在搜尋結果中,選取服務端點原則。
- 選擇 + 創建。
- 在 [基本] 索引標籤中,選擇訂用帳戶和虛擬網路的區域。 選擇資源群組,並輸入原則名稱。
- 選取 下一步:原則定義。
- 選取 + 新增資源。 針對服務,選取 [Microsoft.Storage]。 在 範圍中,選擇 單一帳戶,然後選擇包含你檔案共享的儲存帳戶。 選取 ,然後新增。 對子網路中用戶端使用的每個儲存帳號重複此步驟。
- 選取 檢閱 + 建立,然後選取 建立。
- 前往新的服務端點原則。 在服務選單中,在 設定中選擇 相關子網路。
- 選擇 編輯子網路關聯,選擇虛擬網路和子網路,然後選擇 套用。
以下 PowerShell 指令建立服務端點原則並將其與子網關聯。 該政策限制用戶端從該子網路透過服務端點存取一個儲存帳號。 子網路必須已經有 Microsoft.Storage 服務端點。 用你自己的值替換佔位符值。
$storageAccountResourceGroupName = "<storage-account-resource-group>"
$storageAccountName = "<storage-account-name>"
$virtualNetworkResourceGroupName = "<vnet-resource-group-name>"
$virtualNetworkName = "<vnet-name>"
$subnetName = "<subnet-name>"
$policyName = "<service-endpoint-policy-name>"
$storageAccountParams = @{
ResourceGroupName = $storageAccountResourceGroupName
Name = $storageAccountName
ErrorAction = "Stop"
}
$storageAccount = Get-AzStorageAccount @storageAccountParams
$virtualNetworkParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $virtualNetworkName
ErrorAction = "Stop"
}
$virtualNetwork = Get-AzVirtualNetwork @virtualNetworkParams
$subnet = $virtualNetwork.Subnets | Where-Object { $_.Name -eq $subnetName }
if ($null -eq $subnet) {
throw "Subnet '$subnetName' wasn't found in virtual network '$virtualNetworkName'."
}
if ($subnet.ServiceEndpointPolicies.Count -gt 0) {
throw "The subnet already has service endpoint policies. Review and update them before changing the configuration."
}
# To allow clients to access more storage accounts, add their resource IDs to ServiceResource.
$policyDefinitionParams = @{
Name = "allowed-storage-accounts"
Service = "Microsoft.Storage"
ServiceResource = @($storageAccount.Id)
ErrorAction = "Stop"
}
$policyDefinition = New-AzServiceEndpointPolicyDefinition @policyDefinitionParams
$policyParams = @{
ResourceGroupName = $virtualNetworkResourceGroupName
Name = $policyName
Location = $virtualNetwork.Location
ServiceEndpointPolicyDefinition = $policyDefinition
ErrorAction = "Stop"
}
$policy = New-AzServiceEndpointPolicy @policyParams
$subnet.ServiceEndpointPolicies = @($policy)
$virtualNetwork | Set-AzVirtualNetwork -ErrorAction Stop | Out-Null
以下 CLI 指令會建立服務端點原則,並將其與子網路關聯。 該政策限制用戶端從該子網路透過服務端點存取一個儲存帳號。 子網路必須已經有 Microsoft.Storage 服務端點。 用你自己的值替換佔位符值。
storageAccountResourceGroupName="<storage-account-resource-group>"
storageAccountName="<storage-account-name>"
virtualNetworkResourceGroupName="<vnet-resource-group-name>"
virtualNetworkName="<vnet-name>"
subnetName="<subnet-name>"
policyName="<service-endpoint-policy-name>"
existingPolicyIds=$(az network vnet subnet show \
--resource-group $virtualNetworkResourceGroupName \
--vnet-name $virtualNetworkName \
--name $subnetName \
--query "serviceEndpointPolicies[].id" --output tsv)
if [ -n "$existingPolicyIds" ]; then
echo "The subnet already has service endpoint policies. Review and update them before changing the configuration." >&2
else
storageAccountId=$(az storage account show \
--resource-group $storageAccountResourceGroupName \
--name $storageAccountName \
--query "id" --output tsv) &&
location=$(az network vnet show \
--resource-group $virtualNetworkResourceGroupName \
--name $virtualNetworkName \
--query "location" --output tsv) &&
az network service-endpoint policy create \
--resource-group $virtualNetworkResourceGroupName \
--name $policyName \
--location $location \
--output none &&
# To allow clients to access more storage accounts, add their resource IDs to --service-resources.
az network service-endpoint policy-definition create \
--resource-group $virtualNetworkResourceGroupName \
--policy-name $policyName \
--name "allowed-storage-accounts" \
--service "Microsoft.Storage" \
--service-resources $storageAccountId \
--output none &&
az network vnet subnet update \
--resource-group $virtualNetworkResourceGroupName \
--vnet-name $virtualNetworkName \
--name $subnetName \
--service-endpoint-policy $policyName \
--output none
fi
若要從具有服務端點政策的子網存取 Microsoft.FileShares 檔案共用,請為該檔案共用建立私人端點。 服務端點政策不適用於經過私有端點的流量。
路由偏好控制來自 Azure 外部用戶端的流量如何抵達公共端點。 它只適用於在 StorageV2 儲存體帳戶中使用隨用隨付帳單模式的傳統 HDD 檔案共用。 如需相關概念,請參閱公用端點網路路由。
Important
不要對 Azure 檔案儲存體 使用網際網路路由。 網際網路路由不支援 Active Directory(AD)網域加入情境或 Azure 檔案同步。保留預設的 Microsoft 路由。
要檢查路由偏好並設定為 Microsoft 路由,請依照以下步驟操作。
- 前往儲存帳戶。
- 在服務選單中,在安全 + 網路中選擇網路。
- 選擇 網路路由 標籤。
- 在路由偏好設定中,請確定選擇了 Microsoft 網路路由。
- 如果你更改了設定,請選擇 儲存。
要設定路由偏好為 Microsoft 路由,請執行以下指令。 用你自己的值替換佔位符值。
$params = @{
ResourceGroupName = "<resource-group>"
Name = "<storage-account-name>"
RoutingChoice = "MicrosoftRouting"
}
Set-AzStorageAccount @params
要設定路由偏好為 Microsoft 路由,請執行以下指令。 用你自己的值替換佔位符值。
az storage account update \
--resource-group <resource-group> \
--name <storage-account-name> \
--routing-choice MicrosoftRouting
Microsoft.FileShares 不支援路由偏好。
相關內容