PowerShell脚本传递集群节点复杂对象的参数设计咨询

核心思路：将集群信息作为整体分组传递 #

把每组集群的主、副节点信息打包成单一对象/结构，避免分散到多个独立参数，大幅提升可读性和维护性，尤其适合集群数量增多的场景。

方案1：自定义类型参数（推荐，强类型校验） #

通过定义自定义类来规范节点和集群的结构，参数直接接收集群对象数组，自带结构校验。

# 定义节点类型，约束必填字段
class ClusterNode {
    [string]$Name
    [string]$IPAddress
    [string]$Role
}

# 定义集群对类型，包含主副节点
class ServerClusterPair {
    [ClusterNode]$PrimaryNode
    [ClusterNode]$SecondaryNode
}

# 脚本参数定义
Param(
    [Parameter(Mandatory=$true)]
    [ServerClusterPair[]]$Clusters
)

调用示例：

# 创建单个节点对象
$webPrimary = [ClusterNode]@{Name='WebserverPrimary'; IPAddress='192.168.1.1'; Role='Webserver'}
$webSecondary = [ClusterNode]@{Name='WebserverBackup'; IPAddress='192.168.1.3'; Role='Webserver'}
$filePrimary = [ClusterNode]@{Name='FileServerPrimary'; IPAddress='192.168.1.2'; Role='FileServer'}
$fileSecondary = [ClusterNode]@{Name='FileServerBackup'; IPAddress='192.168.1.4'; Role='FileServer'}

# 组装集群对数组
$clusters = @(
    [ServerClusterPair]@{PrimaryNode=$webPrimary; SecondaryNode=$webSecondary},
    [ServerClusterPair]@{PrimaryNode=$filePrimary; SecondaryNode=$fileSecondary}
)

# 执行脚本
.\Myscript.ps1 -Clusters $clusters

方案2：哈希表数组（轻量无类型定义） #

如果不想定义自定义类，可以直接用哈希表数组传递，脚本内部自行做结构校验。

Param(
    [Parameter(Mandatory=$true)]
    [hashtable[]]$Clusters
)

# 脚本内校验哈希表结构
foreach ($cluster in $Clusters) {
    if (-not $cluster.PrimaryNode -or -not $cluster.SecondaryNode) {
        throw "每个集群必须包含PrimaryNode和SecondaryNode字段"
    }
    if (-not $cluster.PrimaryNode.Name -or -not $cluster.PrimaryNode.IPAddress -or -not $cluster.PrimaryNode.Role) {
        throw "主节点必须包含Name、IPAddress、Role字段"
    }
    # 同理校验副节点结构...
}

调用示例：

.\Myscript.ps1 -Clusters @(
    @{
        PrimaryNode = @{Name='WebserverPrimary'; IPAddress='192.168.1.1'; Role='Webserver'}
        SecondaryNode = @{Name='WebserverBackup'; IPAddress='192.168.1.3'; Role='Webserver'}
    },
    @{
        PrimaryNode = @{Name='FileServerPrimary'; IPAddress='192.168.1.2'; Role='FileServer'}
        SecondaryNode = @{Name='FileServerBackup'; IPAddress='192.168.1.4'; Role='FileServer'}
    }
)

方案3：JSON配置文件（适合大量集群） #

当集群数量较多时，将配置写入JSON文件，脚本接收文件路径参数，读取后解析使用，便于批量维护。

JSON配置文件cluster-config.json：

[
    {
        "PrimaryNode": {
            "Name": "WebserverPrimary",
            "IPAddress": "192.168.1.1",
            "Role": "Webserver"
        },
        "SecondaryNode": {
            "Name": "WebserverBackup",
            "IPAddress": "192.168.1.3",
            "Role": "Webserver"
        }
    },
    {
        "PrimaryNode": {
            "Name": "FileServerPrimary",
            "IPAddress": "192.168.1.2",
            "Role": "FileServer"
        },
        "SecondaryNode": {
            "Name": "FileServerBackup",
            "IPAddress": "192.168.1.4",
            "Role": "FileServer"
        }
    }
]

脚本参数设计：

Param(
    [Parameter(Mandatory=$true)]
    [string]$ClusterConfigPath
)

# 读取并解析JSON配置
$clusters = Get-Content $ClusterConfigPath | ConvertFrom-Json

调用示例：

.\Myscript.ps1 -ClusterConfigPath .\cluster-config.json

内容的提问来源于stack exchange，提问作者Bobby Dore