部署 Azure 文件同步

2025-08-18

使用 Azure 文件同步，即可将组织的文件共享集中在 Azure 文件中，同时又不失本地文件服务器的灵活性、性能和兼容性。 Azure 文件同步可将 Windows Server 转换为 Azure 文件共享的快速缓存。可以使用 Windows Server 上可用的任意协议本地访问数据，包括 SMB、NFS 和 FTPS。您可以在世界各地根据需求设置任意数量的缓存。

强烈建议先阅读规划 Azure 文件部署和规划 Azure 文件同步部署，再按照本文中的步骤进行操作。

Prerequisites

要部署 Azure 文件同步的同一区域中的 Azure 文件共享 。建议为所有新部署预配 v2 文件共享。有关详细信息，请参见:
- Azure 文件同步的适用地区。
- 创建文件共享，了解创建文件共享的分步说明。
- 了解预配的 v2 计费模型，了解如何使用预配的 v2 模型。
必须启用以下存储帐户设置才能允许 Azure 文件同步访问存储帐户：
- SMB 安全设置必须允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。
- “允许存储帐户密钥访问”必须为“启用”。若要检查此设置，请导航到存储帐户，然后选择“设置”部分下的“配置”。
至少有一个受支持的 Windows Server 实例与 Azure 文件同步进行同步。有关受支持的 Windows Server 版本和建议的系统资源的详细信息，请参阅 Windows 文件服务器注意事项。
必须在 Windows Server 上安装以下 Windows 更新：
- Windows Server 2012 R2：KB5021653
- Windows Server 2016：KB5040562
- Windows Server 2019：KB5005112 和 KB5040430
注册服务器并创建云终结点的管理员必须是给定存储同步服务的管理角色成员，角色包括 Azure 文件同步管理员、所有者或参与者。可以在 Azure 门户中存储同步服务的访问控制（IAM）下配置此配置。
可选：如果打算对 Windows Server 故障转移群集使用 Azure 文件同步，则必须先配置“通用文件服务器”角色，然后再在群集中的每个节点上安装 Azure 文件同步代理。有关如何在故障转移集群上配置“通用文件服务器”角色的详细信息，请参阅部署双节点群集文件服务器。

Note

Azure 文件同步支持的唯一方案是使用群集磁盘的 Windows Server 故障转移群集。有关 Azure 文件同步，请参阅故障转移群集。
尽管可以使用 Azure 门户进行云管理，但高级注册服务器功能是通过 PowerShell cmdlet 提供的，这些 cmdlet 预期在 PowerShell 5.1 或 PowerShell 6+ 中运行于本地。在 Windows Server 2012 R2 上，可通过查看 $PSVersionTable 对象的“PSVersion”属性值来验证是否至少正在运行 PowerShell 5.1.*：
```
$PSVersionTable.PSVersion
```
如果 PSVersion 值低于 5.1.*，需要通过下载并安装 Windows Management Framework (WMF) 5.1 进行升级。需下载和安装的 Windows Server 2012 R2 的相应包为 Win8.1AndW2K12R2-KB*******-x64.msu。

PowerShell 6+ 可用于任何受支持的系统，并且可以通过其 GitHub 页面下载。

要部署 Azure 文件同步的同一区域中的 Azure 文件共享 。建议为所有新部署预配 v2 文件共享。有关详细信息，请参见:
- Azure 文件同步的适用地区。
- 创建文件共享，了解创建文件共享的分步说明。
- 了解预配的 v2 计费模型，了解如何使用预配的 v2 模型。
必须启用以下存储帐户设置才能允许 Azure 文件同步访问存储帐户：
- SMB 安全设置必须允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。
- “允许存储帐户密钥访问”必须为“启用”。若要检查此设置，请导航到存储帐户，然后选择“设置”部分下的“配置”。
注册服务器并创建云终结点的管理员必须是给定存储同步服务的管理角色成员，角色包括 Azure 文件同步管理员、所有者或参与者。可以在 Azure 门户中存储同步服务的访问控制（IAM）下配置此配置。
至少有一个受支持的 Windows Server 实例与 Azure 文件同步进行同步。有关受支持的 Windows Server 版本和建议的系统资源的详细信息，请参阅 Windows 文件服务器注意事项。
必须在 Windows Server 上安装以下 Windows 更新：
- Windows Server 2012 R2：KB5021653
- Windows Server 2016：KB5040562
- Windows Server 2019：KB5005112 和 KB5040430
可选：如果打算对 Windows Server 故障转移群集使用 Azure 文件同步，则必须先配置“通用文件服务器”角色，然后再在群集中的每个节点上安装 Azure 文件同步代理。有关如何在故障转移集群上配置“通用文件服务器”角色的详细信息，请参阅部署双节点群集文件服务器。

Note

Azure 文件同步支持的唯一方案是使用群集磁盘的 Windows Server 故障转移群集。有关 Azure 文件同步，请参阅故障转移群集。
PowerShell 5.1 或 PowerShell 6+。可以在任何受支持的系统（包括非 Windows 系统）上使用 Azure 文件同步的 Az PowerShell 模块，但服务器注册 cmdlet 必须始终在要注册的 Windows 服务器实例上运行（可以直接完成或通过 PowerShell 远程完成）。在 Windows Server 2012 R2 上，通过查看 $PSVersionTable 对象的“PSVersion”属性值来验证是否至少正在运行 PowerShell 5.1.*：
```
$PSVersionTable.PSVersion
```
如果 PSVersion 值低于 5.1.*，需要通过下载并安装 Windows Management Framework (WMF) 5.1 进行升级。需下载和安装的 Windows Server 2012 R2 的相应包为 Win8.1AndW2K12R2-KB*******-x64.msu。

PowerShell 6+ 可用于任何受支持的系统，并且可以通过其 GitHub 页面下载。
如果已选择使用 PowerShell 5.1，请确保至少安装了 .NET 4.7.2。详细了解系统上的 .NET Framework 版本和依赖项。
Important

如果在 Windows Server Core 上安装 .NET 4.7.2 及以上版本，则必须用 quiet 和 norestart 标志安装，否则安装将失败。例如，如果安装 .NET 4.8，则命令将如下所示：
```
Start-Process -FilePath "ndp48-x86-x64-allos-enu.exe" -ArgumentList "/q /norestart" -Wait
```
Az PowerShell 模块可以按照此处的说明进行安装：安装和配置 Azure PowerShell。

Note

现在，安装 Az PowerShell 模块时将自动安装 Az.StorageSync 模块。

要部署 Azure 文件同步的同一区域中的 Azure 文件共享 。建议为所有新部署预配 v2 文件共享。有关详细信息，请参见:
- Azure 文件同步的适用地区。
- 创建文件共享，了解创建文件共享的分步说明。
- 了解预配的 v2 计费模型，了解如何使用预配的 v2 模型。
必须启用以下存储帐户设置才能允许 Azure 文件同步访问存储帐户：
- SMB 安全设置必须允许 SMB 3.1.1 协议版本、NTLM v2 身份验证和 AES-128-GCM 加密。若要查看存储帐户的 SMB 安全设置，请参阅 SMB 安全设置。
- “允许存储帐户密钥访问”必须为“启用”。若要检查此设置，请导航到存储帐户，然后选择“设置”部分下的“配置”。
注册服务器并创建云终结点的管理员必须是给定存储同步服务的管理角色成员，角色包括 Azure 文件同步管理员、所有者或参与者。可以在 Azure 门户中存储同步服务的访问控制（IAM）下配置此配置。
至少有一个受支持的 Windows Server 实例与 Azure 文件同步进行同步。有关受支持的 Windows Server 版本和建议的系统资源的详细信息，请参阅 Windows 文件服务器注意事项。
必须在 Windows Server 上安装以下 Windows 更新：
- Windows Server 2012 R2：KB5021653
- Windows Server 2016：KB5040562
- Windows Server 2019：KB5005112 和 KB5040430
可选：如果打算对 Windows Server 故障转移群集使用 Azure 文件同步，则必须先配置“通用文件服务器”角色，然后再在群集中的每个节点上安装 Azure 文件同步代理。有关如何在故障转移集群上配置“通用文件服务器”角色的详细信息，请参阅部署双节点群集文件服务器。

Note

Azure 文件同步支持的唯一方案是使用群集磁盘的 Windows Server 故障转移群集。有关 Azure 文件同步，请参阅故障转移群集。
安装 Azure CLI
登录。

如果使用的是 CLI 的本地安装，请使用 az login 命令登录。
```
az login
```
遵循终端中显示的步骤完成身份验证过程。

安装 az filesync Azure CLI 扩展。

az extension add --name storagesync

安装 storagesync 扩展引用后，你将收到以下警告。

The installed extension 'storagesync' is experimental and not covered by customer support. Please use with discretion.

尽管可以使用 Azure CLI 进行云管理，但高级注册服务器功能是通过 PowerShell cmdlet 提供的，这些 cmdlet 预期在 PowerShell 5.1 或 PowerShell 6+ 中运行于本地。在 Windows Server 2012 R2 上，可通过查看 $PSVersionTable 对象的“PSVersion”属性值来验证是否正在运行 PowerShell 5.1.* 或以上版本：
```
$PSVersionTable.PSVersion
```
如果 PSVersion 值低于 5.1.*，需要通过下载并安装 Windows Management Framework (WMF) 5.1 进行升级。需下载和安装的 Windows Server 2012 R2 的相应包为 Win8.1AndW2K12R2-KB*******-x64.msu。

PowerShell 6+ 可用于任何受支持的系统，并且可以通过其 GitHub 页面下载。

准备 Windows Server，用于 Azure 文件同步

对于要与 Azure 文件同步配合使用的每个服务器（包括故障转移群集中的服务器节点），请禁用“Internet Explorer 增强的安全性配置”。这仅在初始服务器注册时需要。可在注册服务器后重新启用。

Note

如果要在 Windows Server Core 上部署 Azure 文件同步，则可以跳过此步骤。

打开服务器管理器。
单击“本地服务器”：
在“属性”子窗格上，选择“IE 增强的安全性配置”的链接。
在“Internet Explorer 增强的安全配置”对话框中，为“管理员”和“用户”选择“关”：

若要禁用“Internet Explorer 增强的安全性配置”，请在权限提升的 PowerShell 会话中执行以下命令：

$installType = (Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\").InstallationType

# This step is not required for Server Core
if ($installType -ne "Server Core") {
    # Disable Internet Explorer Enhanced Security Configuration 
    # for Administrators
    Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Active Setup\Installed Components\{A509B1A7-37EF-4b3f-8CFC-4F3A74704073}" -Name "IsInstalled" -Value 0 -Force

    # Disable Internet Explorer Enhanced Security Configuration 
    # for Users
    Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Active Setup\Installed Components\{A509B1A8-37EF-4b3f-8CFC-4F3A74704073}" -Name "IsInstalled" -Value 0 -Force

    # Force Internet Explorer closed, if open. This is required to fully apply the setting.
    # Save any work you have open in the Internet Explorer browser. This will not affect other browsers,
    # including Microsoft Edge.
    Stop-Process -Name iexplore -ErrorAction SilentlyContinue
}

部署存储同步服务

Azure 文件同步的部署过程首先会将一个“存储同步服务”资源放入所选订阅的资源组中。我们建议尽量少预配这些资源。你将在服务器和此资源之间创建信任关系。一个服务器只能注册到一个存储同步服务。因此，建议根据需要部署尽可能多的存储同步服务以分离服务器组。请记住，不同存储同步服务中的服务器不能彼此同步。

Note

存储同步服务将从其被部署到的订阅和资源组自动继承访问权限。我们建议仔细检查谁有权访问该服务。具有写访问权限的实体可以开始从已注册到此存储同步服务的服务器同步新的文件集，使数据流向这些实体可以访问的 Azure 存储。

要部署存储同步服务，请转到 Azure 门户，选择“创建资源”，然后搜索“Azure 文件同步”。在搜索结果中，选择“Azure 文件同步”，然后选择“创建”，打开“部署存储同步”选项卡。

在打开的窗格中，输入以下信息：

名称：存储同步服务的唯一名称（按区域）。
订阅：需要在其中创建存储同步服务的订阅。根据您组织的配置策略，您可能有权访问一个或多个订阅。 Azure 订阅是对每项云服务（如 Azure 文件）计费的最基本容器。
资源组：资源组是 Azure 资源（如存储帐户或存储同步服务）的逻辑组。可以为 Azure 文件同步创建新的资源组，也可对其使用现有资源组。建议使用资源组作为用于从逻辑上隔离组织资源的容器，例如对 HR 资源或特定项目资源进行分组。
位置：要在其中部署 Azure 文件同步的区域。此列表中仅提供受支持的区域。

完成后请选择“创建”，部署存储同步服务。

使用自己的值替换 <Az_Region>、<RG_Name> 和 <my_storage_sync_service>，然后使用以下命令创建并部署存储同步服务：

$hostType = (Get-Host).Name

if ($installType -eq "Server Core" -or $hostType -eq "ServerRemoteHost") {
    Connect-AzAccount -UseDeviceAuthentication
}
else {
    Connect-AzAccount -Environment AzureChinaCloud
}

# this variable holds the Azure region you want to deploy 
# Azure File Sync into
$region = '<Az_Region>'

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = @()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the selected Azure Region or the region is mistyped.")
}

# the resource group to deploy the Storage Sync Service into
$resourceGroup = '<RG_Name>'

# Check to ensure resource group exists and create it if doesn't
$resourceGroups = @()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    New-AzResourceGroup -Name $resourceGroup -Location $region
}

$storageSyncName = "<my_storage_sync_service>"
$storageSync = New-AzStorageSyncService -ResourceGroupName $resourceGroup -Name $storageSyncName -Location $region

安装 Azure 文件同步代理

Azure 文件同步代理是一个可下载包，可实现 Windows 服务器与 Azure 文件共享的同步。

可从 Microsoft 下载中心下载代理。下载完成后，双击 MSI 包，开始安装 Azure 文件同步代理。或者，若要以无提示方式安装代理，请参阅如何为新的 Azure 文件同步代理安装执行无提示安装。

选择“下一步”开始安装。
查看并接受最终用户许可协议后，请勾选复选框。选择下一步以继续。
默认情况下，将填充存储同步代理的安装路径。可以将其更改为所选位置。选择下一步以继续。
选择代理设置，然后选择“下一步”。
选择是否要使用 Microsoft 更新来更新文件同步代理，然后选择“下一步”。
选择用于自动更新代理和数据收集的选项，以便根据需要进行故障排除。选择安装开始安装过程。
安装完成后，请选择“完成”以退出安装向导。

Important

如果将对故障转移群集使用 Azure 文件同步，则必须在群集中的每个节点上安装 Azure 文件同步代理。必须注册群集中的每个节点才能使用 Azure 文件同步。

建议执行以下操作：

保留默认安装路径(C:\Program Files\Azure\StorageSyncAgent)，以简化故障排除和服务器维护。
启用 Microsoft 更新，使 Azure 文件同步保持最新。 Azure 文件同步代理的所有更新（包括功能更新和修补程序）都可从 Microsoft 更新进行。建议将最新更新安装到 Azure 文件同步。有关详细信息，请参阅 Azure 文件同步更新策略。

Azure 文件同步代理安装完成后，服务器注册 UI 自动打开。在注册之前，必须创建存储同步服务；请参阅下一部分了解如何创建存储同步服务。

执行以下 PowerShell 代码，以下载适用于所用 OS 的 Azure 文件同步代理版本，并将其安装在系统上。

Important

如果要对故障转移群集使用 Azure 文件同步，则必须在群集中的每个节点上安装 Azure 文件同步代理。必须注册群集中的每个节点才能使用 Azure 文件同步。

# Gather the OS version
$osver = [System.Environment]::OSVersion.Version

# Download the appropriate version of the Azure File Sync agent for your OS.
if ($osver.Equals([System.Version]::new(10, 0, 20348, 0))) {
    Invoke-WebRequest `
        -Uri https://aka.ms/afs/agent/Server2022 `
        -OutFile "StorageSyncAgent.msi" 
} elseif ($osver.Equals([System.Version]::new(10, 0, 17763, 0))) {
    Invoke-WebRequest `
        -Uri https://aka.ms/afs/agent/Server2019 `
        -OutFile "StorageSyncAgent.msi" 
} elseif ($osver.Equals([System.Version]::new(10, 0, 14393, 0))) {
    Invoke-WebRequest `
        -Uri https://aka.ms/afs/agent/Server2016 `
        -OutFile "StorageSyncAgent.msi" 
} elseif ($osver.Equals([System.Version]::new(6, 3, 9600, 0))) {
    Invoke-WebRequest `
        -Uri https://aka.ms/afs/agent/Server2012R2 `
        -OutFile "StorageSyncAgent.msi" 
} else {
    throw [System.PlatformNotSupportedException]::new("Azure File Sync is only supported on Windows Server 2012 R2, Windows Server 2016, Windows Server 2019 and Windows Server 2022")
}

# Install the MSI. Start-Process is used to PowerShell blocks until the operation is complete.
# Note that the installer currently forces all PowerShell sessions closed - this is a known issue.
Start-Process -FilePath "StorageSyncAgent.msi" -ArgumentList "/quiet" -Wait

# Note that this cmdlet will need to be run in a new session based on the above comment.
# You may remove the temp folder containing the MSI and the EXE installer
Remove-Item -Path ".\StorageSyncAgent.msi" -Recurse -Force

向存储同步服务注册 Windows Server

向存储同步服务注册 Windows Server 可在服务器（或群集）与存储同步服务之间建立信任关系。一个服务器只能注册到一个存储同步服务，并可与同一存储同步服务关联的其他服务器和 Azure 文件共享同步。

Note

服务器注册使用 Azure 凭据在存储同步服务和 Windows Server 之间创建信任关系。随后，服务器创建并使用自己的标识，只要服务器保持注册状态且当前的共享访问签名 (SAS) 令牌有效，该标识就是有效的。取消注册服务器后，无法将新的 SAS 令牌颁发给服务器，因此，服务器无法访问 Azure 文件共享，并停止任何同步。

注册服务器的管理员必须是给定存储 同步服务的 Azure 文件同步管理员、 所有者 或 参与者 的管理角色的成员。这可以在 Azure 门户中的“访问控制(IAM)”下针对存储同步服务进行配置。

此外，还可以区分能够注册服务器的管理员和可以在存储同步服务中配置同步的管理员。为此，需要创建一个自定义角色，列出只允许注册服务器的管理员，并为自定义角色提供以下权限：

"Microsoft.StorageSync/storageSyncServices/registeredServers/write"
"Microsoft.StorageSync/storageSyncServices/read"
"Microsoft.StorageSync/storageSyncServices/workflows/read"
"Microsoft.StorageSync/storageSyncServices/workflows/operations/read"

服务器注册 UI 应该会在 Azure 文件同步代理安装后自动打开。如果没有，可以从其文件位置手动将其打开：C:\Program Files\Azure\StorageSyncAgent\ServerRegistration.exe。服务器注册 UI 打开时，可以从给定的选项中选择 AzureChinaCloud。服务器注册 UI 登录 - 常规的屏幕截图。

如果你是云解决方案提供商，请切换“我以云解决方案提供商身份登录”开关，并输入租户 ID。服务器注册 UI 登录云解决方案提供商的屏幕截图。

选择“登录”以开始。

登录后，系统会提示输入以下信息：

存储同步服务的服务器注册的屏幕截图，其中包含订阅、资源组和同步服务的详细信息。

Azure 订阅：包含存储同步服务的订阅（请参阅部署存储同步服务）。
资源组：包含存储同步服务的资源组。
存储同步服务：想要向其注册的存储同步服务的名称。

选择相应的信息，然后选择“注册”完成服务器注册。在注册过程中，系统会提示您进行额外的登录。

$registeredServer = Register-AzStorageSyncServer -ParentObject $storageSync

创建同步组和云终结点

同步组定义一组文件的同步拓扑。同步组中的端点保持彼此同步。同步组中必须包含一个表示 Azure 文件共享的云终结点，以及一个或多个服务器终结点。服务器终结点表示已注册的服务器上的路径。服务器可以包含多个同步组中的服务器终结点。可以创建任意数量的同步组，以适当地描述所需的同步拓扑。

云终结点是指向 Azure 文件共享的指针。所有服务器终结点将与某个云终结点同步，使该云终结点成为中心。 Azure 文件共享的存储帐户必须位于存储同步服务所在的同一个区域。将同步整个 Azure 文件共享，但存在一种例外情况：将预配一个特殊的文件夹，它相当于 NTFS 卷上的“System Volume Information”隐藏文件夹。此目录名为“.SystemShareInformation”。其中包含不会同步到其他终结点的重要同步元数据。请勿使用或删除它！

Important

可对同步组中的任何云终结点或服务器终结点进行更改，并将文件同步到同步组中的其他终结点。如果直接对云终结点（Azure 文件分享）进行更改，首先需要通过 Azure 文件同步更改检测作业来发现更改。每 24 小时仅针对云终结点启动一次更改检测作业。有关详细信息，请参阅 Azure 文件常见问题解答。

创建云终结点的管理员必须是包含云终结点所指向的 Azure 文件共享的存储帐户的管理角色 Azure 文件同步管理员 或 所有者 的成员。可以在 Azure 门户中的“访问控制(IAM)”下针对存储帐户对此进行配置。

若要创建同步组，请在 Azure 门户中转到存储同步服务，然后选择“+ 创建同步组”：

在 Azure 门户中创建新同步组的屏幕截图。

在打开的窗格中输入以下信息，创建具有云终结点的同步组：在 Azure 门户中创建新同步组的屏幕截图-“信息”。

同步组名称：要创建的同步组的名称。此名称在存储同步服务内必须是唯一的，但可以是符合逻辑的任何名称。
订阅：在部署存储同步服务中用于部署存储同步服务的订阅。
存储帐户：如果选择“选择存储账户”，另一个窗格随即出现，可在其中选择包含要同步的 Azure 文件共享的存储帐户。
Azure 文件共享：要与其同步的 Azure 文件共享的名称。

创建后，应会在“同步组”页上看到“正常”状态。具有“正常”状态的“同步组”页的屏幕截图。

使用同步组自动创建云终结点。选择最近创建的同步组。应该能够查看云终结点。如果没有看到云终结点，则云终结点创建可能会由于权限不足而失败。若要解决此问题，请尝试创建云终结点并参阅云终结点创建故障排除。

单击同步组名称并选择“+ 添加云终结点”以将云终结点添加到同步组。在 Azure 门户中创建新云终结点的屏幕截图。

在打开的窗格中，输入要与之同步的订阅、存储帐户和文件共享。创建新云终结点的屏幕截图 -“信息”。

若要创建同步组，请执行以下 PowerShell。将 <my-sync-group> 替换为同步组的所需名称。

$syncGroupName = "<my-sync-group>"
$syncGroup = New-AzStorageSyncGroup -ParentObject $storageSync -Name $syncGroupName

成功创建同步组后，可以创建云终结点。请务必将 <my-storage-account> 和 <my-file-share> 替换为预期的值。

# Get or create a storage account with desired name
$storageAccountName = "<my-storage-account>"
$storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroup | Where-Object {
    $_.StorageAccountName -eq $storageAccountName
}

if ($storageAccount -eq $null) {
    $storageAccount = New-AzStorageAccount `
        -Name $storageAccountName `
        -ResourceGroupName $resourceGroup `
        -Location $region `
        -SkuName Standard_LRS `
        -Kind StorageV2 `
        -EnableHttpsTrafficOnly:$true
}

# Get or create an Azure file share within the desired storage account
$fileShareName = "<my-file-share>"
$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $fileShareName -and $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    $fileShare = New-AzStorageShare -Context $storageAccount.Context -Name $fileShareName
}

# Create the cloud endpoint
New-AzStorageSyncCloudEndpoint `
    -Name $fileShare.Name `
    -ParentObject $syncGroup `
    -StorageAccountResourceId $storageAccount.Id `
    -AzureFileShareName $fileShare.Name

使用 az storagesync sync-group 命令创建新的同步组。若要为所有 CLI 命令默认设置资源组，请使用 az configure。

az storagesync sync-group create --resource-group myResourceGroupName \
                                 --name myNewSyncGroupName \
                                 --storage-sync-service myStorageSyncServiceName \

使用 az storagesync sync-group cloud-endpoint 命令创建新的云终结点。

az storagesync sync-group cloud-endpoint create --resource-group myResourceGroup \
                                                --storage-sync-service myStorageSyncServiceName \
                                                --sync-group-name mySyncGroupName \
                                                --name myNewCloudEndpointName \
                                                --storage-account mystorageaccountname \
                                                --azure-file-share-name azure-file-share-name

创建服务器终结点

服务器终结点代表已注册服务器上的特定位置，例如服务器卷中的文件夹。服务器终结点受以下条件约束：

服务器终结点必须是已注册的服务器（而不是装载式共享）上的路径。不支持网络连接存储 (NAS)。
尽管服务器终结点可以位于系统卷上，但系统卷上的服务器终结点无法使用云端分层。
不支持在卷上创建服务器终结点后更改路径或驱动器号。请确保在已注册的服务器上使用最终路径。
已注册的服务器可以支持多个服务器终结点。但是，在任意时刻，一个同步组中每个已注册的服务器只能有一个服务器终结点。同步组中的其他服务器终结点必须位于不同的已注册的服务器上。

要添加服务器终结点，请转到新创建的同步组。在“服务器终结点”下，选择“+添加服务器终结点”。 “添加服务器终结点”边栏选项卡随即打开。输入以下信息以创建服务器终结点：

显示“添加服务器终结点”边栏选项卡的屏幕截图。

已注册的服务器：想要创建服务器终结点的服务器或群集的名称。
路径：要同步到 Azure 文件共享的 Windows Server 上的路径。路径可以是文件夹（例如 D:\Data）、卷根（例如 D:\）或卷装入点（例如 D:\Mount）。
云分层：启用或禁用云分层的开关。通过云分层可以将不常使用或访问的文件分层到 Azure 文件。启用云分层后，你可以设置两种策略来通知 Azure 文件同步何时对冷文件进行分层：卷可用空间策略和日期策略。
- 卷可用空间：要在服务器终结点所在的卷上保留的可用空间量。例如，如果在只有一个服务器终结点的卷上将卷可用空间设置为 50%，则大约一半的数据量将分层到 Azure 文件存储。不管是否启用云分层，Azure 文件共享在同步组中始终具有完整的数据副本。
- 日期策略：如果未对文件进行访问（即读取或写入）的天数达到指定的天数，则将文件分层到云。例如，如果你注意到超过 15 天没有访问的文件通常是归档文件，则应该把日期策略设置为 15 天。
初始同步：“初始同步”部分仅适用于同步组中的第一个服务器终结点（在一个同步组中创建多个服务器终结点时，此部分更改为“初始下载”）。在“初始同步”部分，可以选择“初始上传”和“初始下载”行为。
- 初始上传：可以选择服务器将数据初始上传到 Azure 文件共享的方式：
  - 选项 1：将此服务器路径的内容与 Azure 文件共享中的内容合并。具有相同名称和路径的文件在内容不同时会导致冲突。这些文件的两个版本将并排存储。如果服务器路径或 Azure 文件共享为空，请始终选择此选项。
  - 选项 2：授权地用此服务器路径中的内容覆盖 Azure 文件共享中的文件和文件夹。此选项可以避免文件冲突。
  要了解详细信息，请参阅初始同步。
- 初始下载：可以选择服务器初始下载 Azure 文件共享数据的方式。当服务器连接到包含文件的 Azure 文件共享时，此设置非常重要。 “命名空间”表示不包含文件内容的文件和文件夹结构。 “分层文件”的文件内容通过本地访问或策略从云回调到服务器。
  - 选项 1：先下载命名空间，然后回收文件内容，只要本地磁盘容纳得下。
  - 选项 2：仅下载命名空间。文件内容在进行访问时回收。
  - 选项 3：避免分层文件。文件只有在完全下载后才会显示在服务器上。
  要了解详细信息，请参阅初始下载。

要添加服务器终结点，请选择“创建”。您的文件现在在 Azure 文件共享和 Windows Server 之间保持同步。

Note

在创建服务器终结点之前，Azure 文件同步会将 Azure 文件共享的快照作为备份。此快照可用于将共享还原到在创建服务器终结点之前的状态。创建服务器终结点后，不会自动移除快照，因此，如果不需要快照，可以手动删除它。可以查看 Azure 文件共享的快照，并在发起方列中检查 AzureFileSync，以此来查找由 Azure File Sync 创建的快照。

执行以下 PowerShell 命令创建服务器终结点（请务必将 <your-server-endpoint-path> 和 <your-volume-free-space> 替换为所需值）。检查可选初始下载和初始上传策略的设置。

$serverEndpointPath = "<your-server-endpoint-path>"
$cloudTieringDesired = $true
$volumeFreeSpacePercentage = <your-volume-free-space>
# Optional property. Choose from: [NamespaceOnly] default when cloud tiering is enabled. [NamespaceThenModifiedFiles] default when cloud tiering is disabled. [AvoidTieredFiles] only available when cloud tiering is disabled.
$initialDownloadPolicy = "NamespaceOnly"
$initialUploadPolicy = "Merge"
# Optional property. Choose from: [Merge] default for all new server endpoints. Content from the server and the cloud merge. This is the right choice if one location is empty or other server endpoints already exist in the sync group. [ServerAuthoritative] This is the right choice when you seeded the Azure file share (e.g. with Data Box) AND you are connecting the server location you seeded from. This enables you to catch up the Azure file share with the changes that happened on the local server since the seeding.

if ($cloudTieringDesired) {
    # Ensure endpoint path is not the system volume
    $directoryRoot = [System.IO.Directory]::GetDirectoryRoot($serverEndpointPath)
    $osVolume = "$($env:SystemDrive)\"
    if ($directoryRoot -eq $osVolume) {
        throw [System.Exception]::new("Cloud tiering cannot be enabled on the system volume")
    }

    # Create server endpoint
    New-AzStorageSyncServerEndpoint `
        -Name $registeredServer.FriendlyName `
        -SyncGroup $syncGroup `
        -ServerResourceId $registeredServer.ResourceId `
        -ServerLocalPath $serverEndpointPath `
        -CloudTiering `
        -VolumeFreeSpacePercent $volumeFreeSpacePercentage `
        -InitialDownloadPolicy $initialDownloadPolicy `
        -InitialUploadPolicy $initialUploadPolicy
} else {
    # Create server endpoint
    New-AzStorageSyncServerEndpoint `
        -Name $registeredServer.FriendlyName `
        -SyncGroup $syncGroup `
        -ServerResourceId $registeredServer.ResourceId `
        -ServerLocalPath $serverEndpointPath `
        -InitialDownloadPolicy $initialDownloadPolicy
}

使用 az storagesync sync-group server-endpoint 命令创建新的服务器终结点。

# Create a new sync group server endpoint 
az storagesync sync-group server-endpoint create --resource-group myResourceGroupName \
                                                 --name myNewServerEndpointName
                                                 --registered-server-id 91beed22-7e9e-4bda-9313-fec96c286e0
                                                 --server-local-path d:\myPath
                                                 --storage-sync-service myStorageSyncServiceNAme
                                                 --sync-group-name mySyncGroupName

# Create a new sync group server endpoint with additional optional parameters
az storagesync sync-group server-endpoint create --resource-group myResourceGroupName \
                                                 --storage-sync-service myStorageSyncServiceName \
                                                 --sync-group-name mySyncGroupName \
                                                 --name myNewServerEndpointName \
                                                 --registered-server-id 91beed22-7e9e-4bda-9313-fec96c286e0 \
                                                 --server-local-path d:\myPath \
                                                 --cloud-tiering on \
                                                 --volume-free-space-percent 85 \
                                                 --tier-files-older-than-days 15 \
                                                 --initial-download-policy NamespaceOnly [OR] NamespaceThenModifiedFiles [OR] AvoidTieredFiles
                                                 --initial-upload-policy Merge [OR] ServerAuthoritative

可选：配置防火墙和虚拟网络设置

Portal

如果您想配置 Azure 文件同步以使用防火墙和虚拟网络设置，请按以下步骤操作：

从 Azure 门户导航到要保护的存储帐户。
从服务菜单中的“安全性 + 网络”下，选择“网络”。
在“公用网络访问”下，单击“从所选虚拟网络和 IP 地址启用”。
确保服务器的 IP 地址或虚拟网络列在“地址范围”部分下。
确保选中“允许受信任服务列表中的 Azure 服务访问此存储帐户”。
选择“保存”以保存设置。

可选：通过早期版本和 VSS（卷影复制服务）进行自助式还原

先前版本是一项 Windows 功能，可用于利用卷的服务器端 VSS 快照将文件的可恢复版本提供给 SMB 客户端。这将直接为信息工作者（而不是依赖 IT 管理员的还原）提供一种功能强大的方案（通常称为自助还原）。

VSS 快照和先前版本的工作方式与 Azure 文件同步无关。但是，必须将云分层设置为兼容模式。许多 Azure 文件同步服务器终结点可存在于同一个卷上。你必须为每个卷进行以下 PowerShell 调用，此 PowerShell 调用甚至有一个计划用于或正在使用云分层的服务器终结点。

Import-Module '<SyncAgentInstallPath>\StorageSync.Management.ServerCmdlets.dll'
Enable-StorageSyncSelfServiceRestore [-DriveLetter] <string> [[-Force]]

VSS 快照包括整个卷。默认情况下，只要有足够的空间来存储快照，一个给定的卷最多可以存在 64 份快照。 VSS 会自动处理这种情况。从星期一到星期五，默认快照计划每天创建两份快照。可以通过 Windows 计划任务来配置该计划。上述 PowerShell cmdlet 执行两项操作：

它配置指定卷上的 Azure 文件同步的云分层，让其可与先前版本兼容，并确保可以从以前的版本中还原文件，即使已将该文件分层到服务器上的云中。
启用默认 VSS 计划。可以决定稍后对其进行修改。

Note

此处需要注意两个要点：

如果你使用 -Force 参数，且当前启用了 VSS，则其将覆盖当前 VSS 快照计划，并将其替换为默认计划。确保在运行 cmdlet 之前保存自定义配置。
如果在群集节点上使用此 cmdlet，则还必须在群集中的所有其他节点上运行该 cmdlet。

若要查看是否已启用自助式还原兼容性，可运行以下 cmdlet：

Get-StorageSyncSelfServiceRestore [[-Driveletter] <string>]

它将列出服务器上的所有卷，以及每个卷的云分层兼容天数。此数字根据每个卷的最大可能快照数和默认快照计划自动计算。因此，默认情况下，提供给信息工作者的所有先前版本均可用于还原。如果更改默认计划以创建更多快照，则情况也是如此。但是，如果你更改计划的方式将导致卷上的可用快照超过兼容天数值，则用户将无法使用从此更旧版本的快照（早期版本）还原。

Note

启用自助式还原可能会影响 Azure 存储使用和帐单。此影响仅限于服务器上当前分层的文件。启用此功能可确保云中提供的文件版本可通过早期版本（VSS 快照）条目进行引用。

如果禁用该功能，则 Azure 存储使用量将慢慢降低，直到兼容天数过去。无法加速。

每个卷的 VSS 快照的默认最大数 (64) 以及获取这些快照的默认计划，导致信息工作者最多可以还原 45 天的先前版本，具体取决于可在卷上存储的 VSS 快照数量。

如果每个卷最多 64 个 VSS 快照并非适合你的正确设置，则可通过注册表项更改该值。要使新限制生效，你需要重新运行 cmdlet，以便在以前启用它的每个卷上启用以前版本的兼容性，并使用 -Force 标记将每个新卷的最大 VSS 快照数纳入考量。这将导致重新计算兼容天数。此更改只会对新的分层文件生效，并覆盖你可能已执行的 VSS 计划中的任何自定义。

默认情况下，VSS 快照最多可占用 10% 的卷空间。若要调整可用于 VSS 快照的存储空间，请使用 vssadmin resize shadowstorage 命令。

Azure 文件同步使用的模式使分布在全球的公司可在本地用户访问任何文件之前，就预先在远程地区的服务器缓存中进行填充。在服务器终结点上启用后，此模式将导致服务器召回在 Azure 文件共享中已创建或更改的文件。

Scenario

Important

紧密地跟踪服务器上 Azure 文件共享中的更改可能会增加出口流量并从 Azure 计费。如果召回到服务器的文件在本地实际上并不需要，那么不建议将文件不必要地召回到服务器。仅针对以下情况使用此模式：你知道使用云中的最新更改预填充服务器上的缓存会对使用该服务器上文件的用户或应用程序产生积极影响。

Portal
PowerShell

在 Azure 门户中，请转到存储同步服务，选择正确的同步组，然后在 Azure 文件共享（云终结点）中，确定想要密切跟踪其更改的服务器终结点。
在“云分层”部分，找到“Azure 文件共享下载”主题。你将看到当前所选模式，可以对其进行更改以更紧密地跟踪 Azure 文件共享更改，并主动将其召回服务器。

该图显示了当前有效的服务器终结点的 Azure 文件共享下载行为，以及用于打开相关菜单以对其进行更改的按钮。

可以通过 Set-AzStorageSyncServerEndpoint cmdlet 修改 PowerShell 中的服务器终结点属性。

# Optional parameter. Default: "UpdateLocallyCachedFiles", alternative behavior: "DownloadNewAndModifiedFiles"
$recallBehavior = "DownloadNewAndModifiedFiles"

Set-AzStorageSyncServerEndpoint -InputObject <PSServerEndpoint> -LocalCacheMode $recallBehavior

可选：服务器终结点上的基于 QUIC 的 SMB

尽管 Azure 文件共享（云终结点）是一个能够从云或本地直接访问的完整 SMB 终结点，但需要在云端访问文件共享数据的客户通常会在托管于 Azure VM 的 Windows Server 实例上部署一个 Azure 文件同步服务器终结点。额外部署一个服务器终结点而不是直接访问 Azure 文件共享的最常见原因是，直接在 Azure 文件共享上所做的更改可能需要长达 24 小时甚至更长时间才能被 Azure 文件同步发现，而在服务器终结点上所做的更改几乎可以立即发现并同步到所有其他服务器和云终结点。

这种配置在有大量远程用户的环境中极为常见。传统上，基于公共 Internet 使用 SMB 访问任何文件共享（包括托管在 Windows 文件服务器上或直接托管在 Azure 文件存储上的文件共享）可能很困难，因为许多组织和 ISP 会阻止端口 445。可以使用专用终结点和 VPN 克服此限制，但 Windows Server 2022 Azure Edition 提供了一种额外的访问策略：基于 QUIC 的 SMB 传输协议。

基于 QUIC 的 SMB 通过端口 443 进行通信，大多数组织和 ISP 都会开放该端口以支持 HTTPS 流量。对于使用 Windows 11 或更高版本的客户端，使用基于 QUIC 的 SMB 可以极大地简化访问托管在 Azure 文件同步服务器终结点上的文件共享所需的网络设置。若要详细了解如何在 Windows Server Azure Edition 上设置和配置基于 QUIC 的 SMB，请参阅适用于 Windows 文件服务器的基于 QUIC 的 SMB。

使用 Azure 文件同步进行载入

若要通过 Azure 文件同步在不停机的情况下首次进行载入，同时保持完整的文件保真度和访问控制列表 (ACL)，则建议采用的步骤如下所述：

部署存储同步服务。
创建一个同步组。
在包含完整数据集的服务器上安装 Azure 文件同步代理。
注册该服务器并在共享中创建一个服务器终结点。
让同步服务执行到 Azure 文件共享（云终结点）的完整上传。
在初始上传完成后，在剩余的每台服务器上安装 Azure 文件同步代理。
在剩余的每台服务器上创建新的文件共享。
使用云分层策略在新的文件共享中创建服务器终结点（如果需要）。（此步骤要求有额外的存储可供初始设置使用。）
让 Azure 文件同步代理在不实际传输数据的情况下快速还原整个命名空间。在完成完整的命名空间同步后，同步引擎将根据服务器终结点的云分层策略填充本地磁盘空间。
确保同步完成，并根据需要测试拓扑。
将用户和应用程序重定向到此新共享。
还可以选择删除服务器上任何重复的共享。

如果您没有额外的存储空间用于初始入门，并希望连接到现有共享，可以使用其他数据传输工具预先将数据播种到 Azure 文件共享中，而不是使用存储同步服务上传数据。仅当可以接受停机时间并绝对保证初始载入过程中服务器共享上没有数据更改时，才建议使用预先进行种子设定方法。

确保任何服务器上的数据在载入过程中都不会发生更改。
通过 SMB 使用任何数据传输工具（例如 Robocopy 或 AzCopy over REST）与服务器数据预先设定 Azure 文件共享种子。如果使用 Robocopy，请确保使用存储帐户访问密钥（请勿使用域标识）装载 Azure 文件共享。如果使用 AzCopy，请确保设置适当的开关，以保留 ACL 时间戳和属性。
使用所需的指向现有共享的服务器终结点创建 Azure 文件同步拓扑。
让同步服务在所有终结点上完成对帐过程。
在对帐完成后，你可以打开共享进行更改。

目前，预先进行种子设定存在一些限制：

在同步拓扑完全启动并运行之前更改服务器上的数据可能会导致服务器终结点上发生冲突。
创建云终结点后，Azure 文件同步在启动初始同步之前会运行一个流程来检测云中的文件。完成此流程所需的时间取决于网速、可用带宽以及文件和文件夹的数目等因素。对于预览版，粗略估计，检测流程以大约每秒 10 个文件的速度运行。因此，当在云中预先播种数据时，即使预先播种运行速度很快，获得完全运行的系统所需的总体时间也会更长。

将 DFS 复制 (DFS-R) 部署迁移至 Azure 文件同步

若要将 DFS-R 部署迁移至 Azure 文件同步，请执行以下操作：

创建一个同步组以表示要替换的 DFS-R 拓扑。
从 DFS-R 拓扑具有完整数据集的服务器开始迁移。在该服务器上安装 Azure 文件同步。
注册该服务器，并为要迁移的第一个服务器创建服务器终结点。请勿启用云分层。
让所有数据同步至你的 Azure 文件共享（云终结点）。
在剩余的每个 DFS-R 服务器上安装并注册 Azure 文件同步代理。
禁用 DFS-R。
在每个 DFS-R 服务器上创建服务器终结点。请勿启用云分层。
确保同步完成，并根据需要测试拓扑。
停用 DFS-R。
现在，可以根据需要在任何服务器终结点上启用云分层。

有关详细信息，请参阅 Azure 文件同步与分布式文件系统 (DFS) 的互操作。

共用方式為

部署 Azure 文件同步

Prerequisites

准备 Windows Server，用于 Azure 文件同步

部署存储同步服务

安装 Azure 文件同步代理

向存储同步服务注册 Windows Server

创建同步组和云终结点

创建服务器终结点

可选：配置防火墙和虚拟网络设置

Portal

可选：通过早期版本和 VSS（卷影复制服务）进行自助式还原

可选：主动从 Azure 文件共享召回新文件和更改的文件

Scenario

启用服务器终结点以主动召回 Azure 文件共享中的更改

可选：服务器终结点上的基于 QUIC 的 SMB

使用 Azure 文件同步进行载入

将 DFS 复制 (DFS-R) 部署迁移至 Azure 文件同步

后续步骤

其他資源