Windows群集共享卷如何添加到故障转移群集,并检查各节点访问状态?
在 Windows Server 故障转移群集中,添加群集共享卷(Cluster Shared Volume,CSV)的顺序是:先确认所有节点都能识别同一块共享磁盘,再将磁盘加入故障转移群集,最后把该磁盘添加到“群集共享卷”。完成后,各节点通常通过 C:\ClusterStorage\VolumeN 访问同一卷,并使用 Get-ClusterSharedVolumeState 检查每个节点是直接访问还是重定向访问。

本文适用于已经部署完成的 Windows Server 故障转移群集,以及通过 FC、iSCSI、共享 SAS 等方式呈现给所有节点的共享磁盘。示例假定群集名为 CLUSTER01,节点为 NODE01 和 NODE02。如果使用的是存储空间直通(S2D),应按照 S2D 的存储池和卷创建流程操作,不要把存储池内部磁盘当作普通共享 LUN 直接添加。
A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,可为 Windows 故障转移群集节点、数据库和企业后台提供独立的计算与存储基础。产品覆盖 Xeon Gold、AMD EPYC、SSD、NVMe 及大容量机械硬盘方案,并配备不同带宽和网络线路,能够结合多节点部署、共享数据访问及跨地区业务场景,构建相应的服务器资源环境。
准备条件与操作边界
需要提前确认的环境
开始操作前,至少检查以下条件:
- 所有节点已安装“故障转移群集”功能,并已加入同一个群集。
- 所有节点都能看到目标共享磁盘,且该磁盘不是任何节点的系统盘。
- 目标磁盘没有被其他群集、应用或独立服务器占用。
- 存储端已经把同一个 LUN 呈现给全部节点。使用 iSCSI 时,应确认每个节点都建立了对应会话;使用多路径时,应按存储厂商要求配置 MPIO。
- 目标磁盘使用受支持的磁盘和文件系统类型。常见 CSV 文件系统为 NTFS 或 ReFS,具体取决于 Windows Server 版本和承载的应用。
- 操作账号具有群集管理权限、本地管理员权限以及访问存储的权限。
- 如果目标磁盘已有数据,必须先确认数据已经备份,且后续不执行初始化、格式化或清除磁盘操作。
CSV 不是普通的网络共享文件夹。添加 CSV 后,节点可以通过本地路径访问,例如:
C:\ClusterStorage\Volume1
如果需要让客户端通过 SMB 访问数据,还需要根据应用场景配置文件服务器角色或其他适用的群集角色,不能把“已加入 CSV”等同于“已经发布 SMB 共享”。
先记录当前状态
建议在变更前记录节点、资源和磁盘信息,便于后续核对或回滚。以下命令应在安装了 FailoverClusters 模块的 Windows PowerShell 中,以管理员身份运行:
Import-Module FailoverClusters
$ClusterName = 'CLUSTER01'
Get-Cluster -Name $ClusterName |
Format-List Name, Domain, QuorumType
Get-ClusterNode -Cluster $ClusterName |
Format-Table Name, State, NodeWeight -AutoSize
Get-ClusterResource -Cluster $ClusterName |
Format-Table Name, ResourceType, State, OwnerGroup, OwnerNode -AutoSize
Get-ClusterSharedVolume -Cluster $ClusterName |
Format-List Name, State, OwnerNode, SharedVolumeInfo
示例结果仅用于说明格式:
Name State
---- -----
NODE01 Up
NODE02 Up
如果存在节点状态为 Down、群集本身无法连接,或者已有磁盘资源处于异常状态,应先处理现有问题,不要在状态不稳定时继续添加新磁盘。
第一步:确认所有节点都识别目标磁盘
查看群集当前可用磁盘
群集服务会根据磁盘签名、共享状态和存储可见性判断哪些磁盘可以加入群集。优先使用 Get-ClusterAvailableDisk 查看候选磁盘:
$AvailableDisks = Get-ClusterAvailableDisk -Cluster $ClusterName
$AvailableDisks |
Format-Table Name, Number, Size, Id -AutoSize
在部分 Windows Server 版本中,输出字段可能略有不同,可以使用以下命令查看完整属性:
$AvailableDisks | Format-List *
目标磁盘应出现在可用磁盘列表中。可重点对照以下信息:
- 磁盘名称是否与存储端提供的 LUN 对应;
- 磁盘容量是否符合预期;
- 磁盘编号、唯一标识或序列信息是否与目标磁盘一致;
- 是否只有目标磁盘被选中,避免误操作其他空闲磁盘。
不要仅根据磁盘编号判断目标磁盘。不同节点上的磁盘编号不一定相同,应结合容量、唯一标识、存储端 LUN 编号等信息确认。
在各节点核对磁盘可见性
可以分别从节点查看磁盘,但不要在每个节点上同时执行初始化、联机或格式化操作:
$Nodes = @('NODE01', 'NODE02')
Invoke-Command -ComputerName $Nodes -ScriptBlock {
Get-Disk |
Select-Object Number, FriendlyName, SerialNumber, Size,
OperationalStatus, IsOffline, IsReadOnly, BusType
} | Format-Table -AutoSize
如果目标磁盘在某个节点完全不存在,或者容量、唯一标识不一致,常见原因包括:
- 存储端只把 LUN 映射给了部分节点;
- iSCSI 会话未在所有节点建立;
- FC 分区或 WWN 映射不完整;
- MPIO 配置不一致;
- 存储端呈现了不同 LUN,而不是同一个共享 LUN;
- 存储设备、HBA 或驱动状态异常。
此时应先修复存储可见性。不要通过强制联机、清除签名等方式“修复”一个实际尚未正确映射的磁盘。
可选:执行存储验证
如果群集刚部署完成,或者共享存储来源发生过变化,可以执行存储验证:
Test-Cluster -Node $Nodes -Include Storage
该命令会生成验证报告。报告中的警告不一定代表当前添加操作必然失败,但需要确认警告是否涉及磁盘保留、路径冗余、驱动、固件或存储兼容性。
第二步:把磁盘添加为群集磁盘资源
使用故障转移群集管理器
图形界面操作路径如下:
- 打开“故障转移群集管理器”。
- 连接到目标群集。
- 展开“存储”,进入“磁盘”。
- 右侧选择“添加磁盘”。
- 在可用磁盘列表中勾选已经确认的目标磁盘。
- 点击“确定”。
添加完成后,目标磁盘会以类似 Cluster Disk 2 的名称出现在群集磁盘资源中。
使用 PowerShell 添加
先列出可用磁盘,再根据已经核对过的名称选择目标对象:
$AvailableDisks = Get-ClusterAvailableDisk -Cluster $ClusterName
$AvailableDisks |
Format-Table Name, Number, Size, Id -AutoSize
确认名称后,将示例中的名称替换为实际值:
$TargetDisk = $AvailableDisks |
Where-Object { $_.Name -eq 'Cluster Disk 2' }
if ($null -eq $TargetDisk) {
throw '未找到指定的可用磁盘,请重新检查存储映射和磁盘名称。'
}
Add-ClusterDisk -InputObject $TargetDisk
也可以先通过名称直接获取群集资源:
$DiskResource = Get-ClusterResource `
-Cluster $ClusterName `
-Name 'Cluster Disk 2'
$DiskResource |
Format-List Name, ResourceType, State, OwnerNode
第一步验证:确认磁盘资源已经加入
Get-ClusterResource -Cluster $ClusterName |
Where-Object { $_.ResourceType -eq 'Physical Disk' } |
Format-Table Name, State, OwnerNode -AutoSize
正常情况下,目标资源会出现在结果中,并且状态为 Online。如果资源已经加入但状态为 Offline,不要直接在所有节点上执行磁盘联机。应先检查群集事件、存储路径和资源依赖关系。
第三步:将群集磁盘添加到群集共享卷
使用故障转移群集管理器
在“故障转移群集管理器”中:
- 进入“存储”。
- 选择“磁盘”。
- 找到刚刚添加的
Cluster Disk 2。 - 右键选择“添加到群集共享卷”。
操作完成后,磁盘不再只是一个由单个节点拥有的群集磁盘,而是可以由多个节点通过 CSV 命名空间访问。
使用 PowerShell 添加
先确认磁盘资源名称:
$DiskResource = Get-ClusterResource `
-Cluster $ClusterName `
-Name 'Cluster Disk 2'
$DiskResource |
Format-List Name, ResourceType, State, OwnerNode
确认该资源确实是目标物理磁盘后,执行:
Add-ClusterSharedVolume `
-Cluster $ClusterName `
-Name $DiskResource.Name
如果 Windows Server 版本支持对象参数,也可以使用:
Add-ClusterSharedVolume `
-Cluster $ClusterName `
-InputObject $DiskResource
以实际环境中的 cmdlet 帮助为准:
Get-Help Add-ClusterSharedVolume -Full
执行期间,群集可能短暂调整磁盘资源状态。不要在操作尚未完成时重复执行添加命令。
第二步验证:查看 CSV 名称和路径
Get-ClusterSharedVolume -Cluster $ClusterName |
Format-List Name, State, OwnerNode, SharedVolumeInfo
重点确认:
State为Online;- 资源名称与目标磁盘一致;
SharedVolumeInfo中可以看到 CSV 的卷信息;- 卷路径通常类似
C:\ClusterStorage\Volume1。
如果需要查看更完整的卷信息,可以执行:
$CsvResources = Get-ClusterSharedVolume -Cluster $ClusterName
$CsvResources |
ForEach-Object {
$_.SharedVolumeInfo | Format-List *
}
不同 Windows Server 版本的属性显示可能不同。如果某个属性没有直接显示,使用 Format-List * 查看实际字段,不要根据单一字段为空就判断 CSV 失败。
第四步:检查每个节点的访问状态
使用 Get-ClusterSharedVolumeState 检查访问模式
Get-ClusterSharedVolumeState 用于查看每个节点对 CSV 的访问状态:
$CsvName = 'Cluster Disk 2'
Get-ClusterSharedVolumeState `
-Cluster $ClusterName `
-Name $CsvName |
Format-Table Node, State, VolumeName -AutoSize
典型示例:
Node State VolumeName
---- ----- ----------
NODE01 Direct C:\ClusterStorage\Volume1
NODE02 Direct C:\ClusterStorage\Volume1
常见状态含义如下:
| 状态 | 含义 | 判断方式 |
|---|---|---|
Direct | 节点直接通过存储路径访问 CSV | 通常是正常工作状态 |
Redirected | 节点通过 CSV 协调节点和群集网络转发 I/O | 可能是维护、备份或存储路径异常导致 |
Paused | 该节点或卷的访问被暂停 | 需要结合群集事件和维护操作判断 |
Offline | 卷或资源未在线 | 不能按正常 CSV 访问使用 |
对于正常运行的共享存储环境,各节点通常应显示为 Direct。但在备份、磁盘维护、存储路径切换等场景下,短时间出现 Redirected 可能是设计行为。关键是确认该状态是否符合当前维护计划,以及是否能够恢复为 Direct。
如果输出属性不完整,可以先查看原始对象:
Get-ClusterSharedVolumeState `
-Cluster $ClusterName `
-Name $CsvName |
Format-List *
从每个节点访问 CSV 命名空间
Get-ClusterSharedVolumeState 检查的是 CSV 状态,还应从每个节点实际访问 CSV 路径。以下命令只执行读取和路径检查,不会创建或删除文件:

$CsvPath = 'C:\ClusterStorage\Volume1'
Invoke-Command -ComputerName $Nodes -ScriptBlock {
param($Path)
try {
$Item = Get-Item -LiteralPath $Path -ErrorAction Stop
[pscustomobject]@{
Node = $env:COMPUTERNAME
Path = $Path
Accessible = $true
IsFolder = $Item.PSIsContainer
Error = $null
}
}
catch {
[pscustomobject]@{
Node = $env:COMPUTERNAME
Path = $Path
Accessible = $false
IsFolder = $false
Error = $_.Exception.Message
}
}
} -ArgumentList $CsvPath |
Format-Table -AutoSize
预期结果类似:
Node Path Accessible IsFolder Error
---- ---- ---------- -------- -----
NODE01 C:\ClusterStorage\Volume1 True True
NODE02 C:\ClusterStorage\Volume1 True True
如果管理主机未启用 PowerShell 远程管理,也可以直接登录每个节点执行:
Test-Path -LiteralPath 'C:\ClusterStorage\Volume1'
Get-Item -LiteralPath 'C:\ClusterStorage\Volume1' |
Format-List FullName, Attributes
这一步只能证明节点能够访问 CSV 命名空间。它不等同于应用账号已经拥有数据目录的读写权限。对于应用验证,应使用应用实际运行身份检查目标目录的 NTFS 权限,并避免为了排查方便而直接授予 Everyone 完全控制权限。
检查卷和群集服务状态
可以补充检查群集服务及卷的基本状态:
Get-Service -ComputerName $Nodes -Name ClusSvc |
Format-Table MachineName, Status, StartType -AutoSize
在每个节点上查看 CSV 路径对应的卷信息:
Invoke-Command -ComputerName $Nodes -ScriptBlock {
Get-Volume |
Where-Object {
$_.Path -like 'C:\ClusterStorage\*' -or
$_.FileSystem -eq 'CSVFS'
} |
Format-Table DriveLetter, FileSystemLabel, FileSystem,
HealthStatus, Size, SizeRemaining -AutoSize
}
部分版本或存储驱动不会在 Path 字段中按预期显示 CSV 路径,因此该命令适合作为辅助检查,不能替代 Get-ClusterSharedVolumeState。
常见异常及处理顺序
排查时建议按照“存储可见性—群集资源—CSV 状态—路径权限”的顺序进行,避免一开始就修改权限或强制切换资源。
| 现象 | 常见原因 | 处理方向 |
|---|---|---|
Get-ClusterAvailableDisk 找不到目标磁盘 | LUN 未呈现给全部节点、路径不一致、磁盘已被占用 | 检查 FC/iSCSI、MPIO、磁盘唯一标识和存储映射 |
| 添加磁盘时提示磁盘正在使用 | 磁盘已有其他群集注册、分区被应用占用或属于其他系统 | 确认所有权和使用者,不要直接清除磁盘签名 |
磁盘资源加入后为 Offline | 存储路径异常、磁盘保留冲突、资源依赖失败 | 检查资源详细信息、群集事件和存储路径 |
| 磁盘已加入群集但没有 CSV 路径 | 只执行了“添加磁盘”,未执行“添加到群集共享卷” | 再确认资源名称,然后执行 CSV 添加操作 |
某节点为 Redirected | 维护模式、备份操作、节点到存储的直接路径异常 | 先确认是否存在计划内维护,再检查存储和群集网络 |
某节点为 Offline 或 Paused | 节点不在群集中、群集服务异常、卷访问被暂停 | 检查节点状态、ClusSvc 和群集事件 |
| 路径存在但应用提示拒绝访问 | NTFS ACL、应用运行账号或安全软件策略不匹配 | 使用实际应用账号核对权限,不要直接扩大权限 |
只有一个节点能看到 C:\ClusterStorage | CSV 状态未正常同步、节点服务异常或节点未完成加入 | 先看 CSV 状态,再检查群集服务和事件日志 |
查看故障转移群集操作日志:
Get-WinEvent `
-ComputerName $Nodes `
-LogName 'Microsoft-Windows-FailoverClustering/Operational' `
-MaxEvents 50 |
Select-Object MachineName, TimeCreated, Id,
LevelDisplayName, Message
如果日志显示存储路径、HBA、MPIO 或设备重置错误,还需要查看系统日志及存储设备管理工具。不要仅通过重启节点掩盖持续性的存储路径问题。
不要使用强制联机代替故障排查
以下操作具有数据风险,不应作为常规修复手段:
Clear-Disk
Format-Volume
Remove-Partition
如果目标磁盘包含已有数据,执行这些命令可能导致分区或文件系统损坏。对于共享磁盘,也不要在多个节点的“磁盘管理”中同时手动联机。磁盘上线、所有权和 CSV 状态应由群集服务统一管理。
完成后的验收检查
可以按以下项目逐项确认:
Get-ClusterNode显示所有预期节点为Up。- 目标磁盘已经从“可用磁盘”变为群集物理磁盘资源。
- 目标磁盘资源状态为
Online。 Get-ClusterSharedVolume显示目标 CSV 为Online。- CSV 路径已经生成,例如
C:\ClusterStorage\Volume1。 Get-ClusterSharedVolumeState为每个在线节点返回一条记录。- 正常工作状态下,各节点访问状态为
Direct;如果为Redirected,已有明确的维护或故障原因。 - 从每个节点执行
Test-Path或Get-Item均能访问 CSV 路径。 - 应用实际运行账号具备所需的 NTFS 权限。
- 群集操作日志中没有与该卷相关的持续性错误。
如果需要验证实际读写能力,应在维护窗口中使用应用专用测试目录,并明确测试账号、测试文件和清理范围。不要直接对生产目录创建临时文件,也不要把管理员账号能够访问误认为应用账号已经可以正常读写。
回滚与撤销方法
回滚前先确认该 CSV 没有被 Hyper-V、数据库、文件服务器角色或其他应用使用,并完成数据备份。回滚只适用于撤销本次新增的群集配置,不适用于修复已有生产数据。
仅取消 CSV 属性
如果只是误将磁盘加入 CSV,但仍希望保留它作为普通群集磁盘,可以先移除 CSV 属性:
Remove-ClusterSharedVolume `
-Cluster $ClusterName `
-Name 'Cluster Disk 2'
执行后再次检查:
Get-ClusterSharedVolume -Cluster $ClusterName
Get-ClusterResource -Cluster $ClusterName |
Where-Object { $_.Name -eq 'Cluster Disk 2' } |
Format-List Name, ResourceType, State, OwnerNode
此操作不会自动等同于格式化或清除磁盘,但仍应在确认没有应用依赖后执行。
从群集中移除新磁盘资源
只有在确认磁盘是本次新增、没有任何应用依赖且数据已备份后,才考虑从群集配置中移除资源:
Remove-ClusterResource `
-Cluster $ClusterName `
-Name 'Cluster Disk 2'
不同版本和管理工具的资源移除行为可能存在差异。执行前应先使用 Get-ClusterResource 核对名称,确认没有删除同名但用途不同的资源。移除群集资源与清除磁盘数据不是同一操作,后续也不要因为磁盘不再显示就继续执行 Clear-Disk 或 Format-Volume。
如果目标 LUN 还要从存储端撤销呈现,应按以下顺序处理:
- 停止并确认应用不再使用该 CSV。
- 移除 CSV 属性。
- 从群集配置中移除磁盘资源。
- 确认所有节点均不再访问该 LUN。
- 最后再按照存储厂商流程撤销 LUN 映射或 iSCSI 会话。
回滚后,重新检查群集节点、磁盘资源、CSV 列表和存储端映射,确认没有残留的资源依赖或节点访问路径。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7569.html



