命令行与文本处理 / 系统课时
使用 Get-Member 检查对象
使用 Get-Member 检查对象
本课通过构造一个包含多种成员类型的对象,练习用 Get-Member 查看成员名称、类别和定义。完成后,你可以在面对陌生命令输出时,先检查对象能力,再设计筛选、计算和方法调用步骤。
学习目标
- 使用
Get-Member查看对象类型与成员清单 - 区分普通属性、别名属性、脚本属性和方法
- 根据
MemberType与Definition选择正确的访问方式
读取对象的成员信息
将对象通过管道传给 Get-Member,命令会检查输入对象,并列出成员的 Name、MemberType 和 Definition。Get-Member 的常用别名是 gm,但教学和生产脚本中写全名更便于阅读。
下面创建一个服务对象,再补充别名属性、计算属性和脚本方法:
$service = [pscustomobject]@{
Name = "api-01"
Port = 8443
Status = "Running"
}
# AliasProperty 为已有属性提供另一个名称
$service | Add-Member -MemberType AliasProperty -Name ServiceName -Value Name
# ScriptProperty 在读取时执行脚本块并计算结果
$service | Add-Member -MemberType ScriptProperty -Name Endpoint -Value {
"https://$($this.Name):$($this.Port)"
}
$service | Add-Member -MemberType ScriptMethod -Name IsHealthy -Value {
$this.Status -eq "Running"
}
$service |
Get-Member -Name GetType, Name, ServiceName, Endpoint, IsHealthy |
Sort-Object Name |
ForEach-Object { "{0}|{1}" -f $_.Name, $_.MemberType }
$service.ServiceName
$service.Endpoint
$service.IsHealthy()预期输出:
Endpoint|ScriptProperty
GetType|Method
IsHealthy|ScriptMethod
Name|NoteProperty
ServiceName|AliasProperty
api-01
https://api-01:8443
True理解常见 MemberType
[pscustomobject] 字面量中的字段通常显示为 NoteProperty。来自 .NET 类型的成员常见为 Property 和 Method。PowerShell 扩展类型系统还可以附加 AliasProperty、ScriptProperty 和 ScriptMethod。
| MemberType | 含义 | 使用方式 |
|---|---|---|
Property、NoteProperty |
对象携带的数据 | $object.Name |
AliasProperty |
指向另一个属性的别名 | $object.ServiceName |
ScriptProperty |
读取时执行脚本块计算值 | $object.Endpoint |
Method、ScriptMethod |
可执行行为 | $object.GetType() |
属性不加圆括号,方法必须加圆括号。只看名称无法可靠判断成员类别,因此陌生对象应先检查 MemberType。
根据 Definition 设计后续处理
完整执行 $service | Get-Member 时,Definition 列会显示属性类型、方法签名或脚本定义。方法可能存在多个重载,签名中的参数类型和数量决定调用方式;属性定义则能帮助判断值是字符串、数字、日期还是其他对象。
确定成员后,再选择合适命令:用 Where-Object 按属性筛选,用 Sort-Object 按属性排序,用 Select-Object 输出需要的成员或计算列;只有业务动作确实由方法提供时,才直接调用方法。
管道检查与集合检查的区别
$items | Get-Member 检查的是集合中逐个流入管道的元素,并按类型汇总结果;Get-Member -InputObject $items 检查的是集合对象本身。前者适合了解每个业务对象有什么字段,后者适合查看数组的 Count、索引和集合方法。
还可以使用 -MemberType Property,Method 缩小类别,使用 -Name *Time* 按名称筛选。-Static 用于查看类型的静态成员,不能与普通实例成员混为一谈。