命令行与文本处理 / 系统课时

使用 Get-Member 检查对象

使用 Get-Member 检查对象

本课通过构造一个包含多种成员类型的对象,练习用 Get-Member 查看成员名称、类别和定义。完成后,你可以在面对陌生命令输出时,先检查对象能力,再设计筛选、计算和方法调用步骤。

学习目标

  • 使用 Get-Member 查看对象类型与成员清单
  • 区分普通属性、别名属性、脚本属性和方法
  • 根据 MemberType 与 Definition 选择正确的访问方式

读取对象的成员信息

将对象通过管道传给 Get-Member,命令会检查输入对象,并列出成员的 Name、MemberType 和 Definition。Get-Member 的常用别名是 gm,但教学和生产脚本中写全名更便于阅读。

下面创建一个服务对象,再补充别名属性、计算属性和脚本方法:

powershell
$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()

预期输出:

text
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 用于查看类型的静态成员,不能与普通实例成员混为一谈。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Get-Member 检查对象

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通