PS对象处理操作常用命令

时间：2022-09-30 18:01:41人气：次作者：快盘下载我要评论

[TOC]

0x00 对象操作处理相关命令

描述: 下述命令常用于对象的相关操作，涉及创建、排序分组与比较等。

Get-Command -Noun Object | ? { $_.Source -eq "Microsoft.PowerShell.Utility" } | Format-Table -Property Name,Version,CommandType
# Name           Version CommandType
# ----           ------- -----------
# Compare-Object 3.1.0.0      Cmdlet
# Group-Object   3.1.0.0      Cmdlet
# Measure-Object 3.1.0.0      Cmdlet
# New-Object     3.1.0.0      Cmdlet
# Select-Object  3.1.0.0      Cmdlet
# Sort-Object    3.1.0.0      Cmdlet
# Tee-Object     3.1.0.0      Cmdlet

0x01 对象创建属性和方法

New-Object 命令 - 创建新的对象

描述: 通过New-Object cmdlet 创建Microsoft.NET Framework或COM对象的实例，您可以指定.NET Framework类的类型(缺省)或COM对象的ProgID(需要使用ComObject参数)。

基础语法:

New-Object [-TypeName] <System.String> [[-ArgumentList] <System.Object[]>] [-Property <System.Collections.IDictionary>] [<CommonParameters>]
New-Object [-ComObject] <System.String> [-Property <System.Collections.IDictionary>] [-Strict] [<CommonParameters>]

参数说明:

TypeName : .NET Framework类。ComObject : 指定要使用的 COM 类的编程标识符（或 ProgId ）(获取请参照基础语法对象章)。Strict : 生成非终止错误(只能在Com对象中使用)。Property : 指定传递的参数采用 { } 进行包含。

基础示例:

# 0.New-Object可以创建一个对象,空对象什么都没有，如果调用它不会返回任何东西, 但可以在后续为他增加方法和属性。
PS > $obj = New-Object object  #空对象

# 1.通过String类输入字符和数字创建一个包含指定个数字符的字符串
PS > New-Object String("*",10)
  # **********

# 2.创建System.Version对象(.NET Framework类)
New-Object -TypeName System.Version -ArgumentList "1.2.3.4"  # 方式1: 通过New-object创建对象
[System.Version]"1.2.3.4" # 方式2: 通过类型转换创建对象
  # Major  Minor  Build  ReVision
  # -----  -----  -----  --------
  # 1      2      3      4

# 3.创建Internet Explorer COM对象(注意必须以管理员权限运行才行)
$IE1 = New-Object -COMObject InternetExplorer.Application.1 -Strict -Property @{Navigate2="www.microsoft.com"; Visible = $True}  # 实践脚本编写中推荐
# 方式2:下面的命令得到与上面示例相同的结果。
$IE2 = New-Object -COMObject InternetExplorer.Application`
$IE2.Navigate2("www.microsoft.com")`
$IE2.Visible = $True`


# 4.将多个参数传递给.net的构造函数 (Collections - 集合)
# PowerShell将数组的每个成员绑定到构造函数的一个参数。
$array = @('One', 'Two', 'Three')
$parameters = @{
    TypeName = 'System.Collections.Generic.HashSet[string]'
    ArgumentList = ([string[]]$array, [System.StringComparer]::OrdinalIgnoreCase)
}
$set = New-Object @parameters     # # $set | Get-Member -MemberType Property 
$set
  # One
  # Two
  # Three
$set.length  # 显示每个字符串的字符串长度
  # 3
  # 3
  # 5

# 5.调用将数组作为单个参数的构造函数
$array = @('One', 'Two', 'Three')
# This command throws an exception.
$set = New-Object -TypeName 'System.Collections.Generic.HashSet[string]' -ArgumentList $array
# This command succeeds.
$set = New-Object -TypeName 'System.Collections.Generic.HashSet[string]' -ArgumentList (,[string[]]$array)
$set
One
Two
Three

# 6.进行事件日志访问
# .NET Framework 类库包括一个名为 System.Diagnostics.EventLog 的类
[System.Diagnostics.EventLog]::GetEventLogs()
  # Max(K) Retain OverflowAction        Entries Log
  # ------ ------ --------------        ------- ---
  # 20,480      0 OverwriteAsNeeded      15,146 Application
  # 20,480      0 OverwriteAsNeeded           0 HardwareEvents
  #    512      7 OverwriteOlder              0 Internet Explorer
  # 20,480      0 OverwriteAsNeeded           0 Key Management Service
  #    128      0 OverwriteAsNeeded          62 OAlerts
  #                                             Security
  # 20,480      0 OverwriteAsNeeded      35,409 System
  # 15,360      0 OverwriteAsNeeded       8,402 Windows PowerShell
# 如果随后键入 $AppLog 你将可以看到它包含应用程序日志：
$AppLog = New-Object -TypeName System.Diagnostics.EventLog -ArgumentList Application
  # Max(K) Retain OverflowAction        Entries Log
  #   ------ ------ --------------        ------- ---
  #   20,480      0 OverwriteAsNeeded      15,146 Application

# 若要访问远程计算机上的应用程序日志，必须同时将日志名称和计算机名称（或 IP 地址）作为参数提供。
$RemoteAppLog = New-Object -TypeName System.Diagnostics.EventLog Application,192.168.1.81
# 采用对象方法清除事件日志, 可以使用 Get-Member 来显示与对象关联的方法
$AppLog | Get-Member -MemberType Method
PS C:WINDOWSsystem32> $AppLog
  Max(K) Retain OverflowAction        Entries Log
  ------ ------ --------------        ------- ---
  20,480      0 OverwriteAsNeeded      15,146 Application

PS C:WINDOWSsystem32> $AppLog.Clear()  # 清除后Entries条目为0
PS C:WINDOWSsystem32> $AppLog
  Max(K) Retain OverflowAction        Entries Log
  ------ ------ --------------        ------- ---
  20,480      0 OverwriteAsNeeded           0 Application

Tips : Windows PowerShell 允许你使用具有 .NET Framework 和 COM 接口的软件组件，使用它们可执行许多系统管理任务。

Tips : 由于大多数 .NET Framework 核心类都包含在 System 命名空间中，所以如果 PS 找不到你指定的类型名称的匹配项，它将自动尝试查找你在 System 命名空间中指定的类,所以可以忽略System。

Tips : 可以采用 New-Object 来处理组件对象模型 (COM) 件，组件的范围从 Windows 脚本宿主 (WSH) 包含的各种库到 ActiveX 应用程序（如大多数系统上安装的 Internet Explorer）。

# 通过指定以下 progid 来创建 WSH 对象： WScript.Shell 、 WScript.Network 、 Scripting.Dictionary 和 Scripting.FileSystemObject
# 有时使用 WSH 类执行某些任务（如创建快捷方式）仍更加简单。
New-Object -ComObject WScript.Shell
New-Object -ComObject WScript.Network
New-Object -ComObject Scripting.Dictionary
New-Object -ComObject Scripting.FileSystemObject

Add-Member 命令 - 向PowerShell对象的实例添加自定义属性和方法。

描述: 该 cmdlet 允许您将成员（属性和方法）添加到PowerShell对象的实例中。例如可以添加包含对象描述的NoteProperty成员或运行脚本以更改对象的ScriptMethod成员。

语法说明

add-Member [-MemberType] {AliasProperty | CodeProperty | Property | NoteProperty | ScriptProperty | Properties | PropertySet | Method | CodeMethod | ScriptMethod | Methods | ParameterizedProperty | MemberSet | Event | Dynamic | All} [-Name] <System.String> [[-Value] <System.Object>] [[-SecondValue] <System.Object>] [-Force] -InputObject <System.Management.Automation.PSObject> [-PassThru] [-TypeName <System.String>] [<CommonParameters>]

Add-Member [-NotePropertyName] <System.String> [-NotePropertyValue] <System.Object> [-Force] -InputObject <System.Management.Automation.PSObject> [-PassThru] [-TypeName <System.String>] [<CommonParameters>]

Add-Member [-NotePropertyMembers] <System.Collections.IDictionary> [-Force] -InputObject <System.Management.Automation.PSObject> [-PassThru] [-TypeName <System.String>] [<CommonParameters>]

Add-Member -InputObject <System.Management.Automation.PSObject> [-PassThru] [-TypeName <System.String>] [<CommonParameters>]

参数说明: MemberType 参数 : 指定要添加到成员的的类型，添加包括属性和方法。

1.属性相关NoteProperty(增加一个属性)Property：真正的属性AliasProperty：另外一个属性的别名CodeProperty：通过静态的.Net方法返回属性的内容ScriptProperty：通过脚本执行返回一个属性的值ParameterizedProperty：需要传递参数的属性2.方法相关ScriptMethod(增加一个执行Powershell脚本方法)Method：正常的方法CodeMethod：映射到静态的.NET方法

PassThru 参数 : 生成输出对象。 Force 参数 : 强制执行比如覆盖已存在的成员(属性)

基础示例:

# 1.创建一个PSObject对象并为其添加属性
PS > $obj=New-Object PSObject
PS > Add-Member -MemberType NoteProperty -Name "A" -Value "1" -InputObject $obj
PS > Add-Member -MemberType NoteProperty -Name "B" -Value "2" -InputObject $obj
PS > Add-Member -MemberType NoteProperty -Name "C" -Value "3" -InputObject $obj
PS > Add-Member -MemberType NoteProperty -Name "D" -Value "4" -InputObject $obj
PS > $obj
# A B C D
# - - - -
# 1 2 3 4
PS > Add-Member -MemberType NoteProperty -Name "E" -Value "5" -InputObject $obj
PS > $obj
# 未知对象格式化ETS遵循一个规律如果对象的属性`少于5个则表格显示，否则列表显示`。
# A : 1
# B : 2
# C : 3
# D : 4
# E : 5

# 2.向表示Test.txt文件的FileInfo对象添加一个值为“Done”的Status note属性。
PS C:UsersWeiyiGeek> $A = Get-ChildItem ping.bat
PS C:UsersWeiyiGeek> $A | Add-Member -NotePropertyName Status -NotePropertyValue Done
PS C:UsersWeiyiGeek> $A.ToString()
  # C:UsersWeiyiGeekping.bat
PS C:UsersWeiyiGeek> $A.Status
  # Done

# 3.以下示例将Size alias属性添加到表示Test.txt文件的对象中，向PSObject添加别名属性。
PS C:UsersWeiyiGeek> $A.Length  # 55 Bytes
PS C:UsersWeiyiGeek> $A | Add-Member -MemberType AliasProperty -Name Size -Value Length # 新属性是长度属性的别名。
PS C:UsersWeiyiGeek> $A.Size    # 55 Bytes

# 4.此示例将StringUse注释属性添加到字符串，因为Add成员不能向字符串输入对象添加类型，最后一个命令显示新属性
$S = "WeiyiGeek"
$S = Add-Member -NotePropertyMembers @{StringUse="Display";StringName="Name"} -InputObject $S -PassThru
$S            # WeiyiGeek
$S.StringUse  # Display
$S.StringName # Name

# 5.创建一个对象给它添加静态属性和动态属性(执行PS脚本返回的值)，以及添加PS脚本方法。
$obj=New-Object PSObject
$d = [ordered]@{Name="Server";System="Server Core";PSVersion="4.0"}
$obj | Add-Member -NotePropertyMembers $d -TypeName Asset -PassThru -Force
  # Name   System      PSVersion
  # ----   ------      ---------
  # Server Server Core 4.0
$obj | Add-Member -MemberType NoteProperty -Name AddTime -Value (get-date)
$obj | Add-Member -MemberType ScriptProperty -Name CurrentTime -Value {get-date}
$obj
  # AddTime            CurrentTime
  # -------            -----------
  # 2021/4/28 22:42:48 2021/4/28 22:43:06
$obj | Add-Member ScriptMethod corkscrew { "Pop! Cheers!" } # 直接通过管道增加一个新方法
Add-member -MemberType ScriptMethod -InputObject $obj demo1 {"I'm is function, $obj "}
Add-Member -memberType ScriptMethod -InputObject $obj -Name demo2 -Value { "I'm Write now, Args : $Args" }
PS C:UsersWeiyiGeek> $obj.demo1()
  #I'm is function, @{AddTime=04/28/2021 22:42:48; CurrentTime=System.Management.Automation.PSScriptProperty}
PS C:UsersWeiyiGeek> $obj.demo2("WeiyiGeek")
  # I'm Write now, Args : WeiyiGeek
PS C:UsersWeiyiGeek> $obj.corkscrew()
  # Pop! Cheers!


# 6.将SizeInMB脚本方法添加到FileInfo对象，该对象将文件大小计算为最接近的兆字节。
$A = Get-ChildItem *.sh  # 可以是多个文件
$S = {[math]::Round(($this.Length / 1MB), 5)}
$A | Add-Member -MemberType ScriptMethod -Name "SizeInMB" -Value $S
$A.SizeInMB()
0.01263
0.00176
0.00164


# 7.此函数用于将一个对象的所有属性复制到另一个对象。foreach循环使用Get-Member cmdlet获取From对象的每个属性。
function Copy-Property ($From, $To)
{
  $properties = Get-Member -InputObject $From -MemberType Property
  foreach ($p in $properties)
  {
    $To | Add-Member -MemberType NoteProperty -Name $p.Name -Value $From.$($p.Name) -Force
  }
}

Get-Member 命令 - 对象属性和方法获取

描述: Get-Member 可帮助发现可用于命令的对象、属性和方法。任何生成基于对象的输出的命令都可以通过管道传递到该Cmdlet中。

Tips : 此处对于属性、对象和方法的名词介绍不在做过多的介绍(学习过面向对象编程的都应该知道)。 Tips ：为了获得关于静态成员的信息，类的成员（而不是实例的成员）使用static参数，要仅获取某些类型的成员如(NoteProperties)请使用MemberType参数。

语法说明:

Get-Member [[-Name] <System.String[]>] [-Force] [-InputObject <System.Management.Automation.PSObject>] [-MemberType {AliasProperty | CodeProperty | Property | NoteProperty | ScriptProperty | Properties | PropertySet | Method | CodeMethod | ScriptMethod | Methods | P
  arameterizedProperty | MemberSet | Event | Dynamic | All}] [-Static] [-View {Extended | Adapted | Base | All}] [<CommonParameters>]

参数说明: MemberType : 指定成员类型取值包括：

Property：真正的属性AliasProperty：另外一个属性的别名CodeProperty：通过静态的.Net方法返回属性的内容NoteProperty：随后增加的属性ScriptProperty：通过脚本执行返回一个属性的值ParameterizedProperty：需要传递参数的属性Method：正常的方法CodeMethod：映射到静态的.NET方法ScriptMethod：一个执行Powershell脚本的方法 Static : 获取成员的静态方法 View ：仅获取特定类型的属性和方法，指定一个或多个值。Extended : 仅获取在Types.ps1xml文件中或通过使用Add Member cmdlet添加的属性和方法。Adapted : 仅获取在PowerShell扩展类型系统中定义的属性和方法。Base : 仅获取.NET对象的原始属性和方法（没有扩展或调整）。All : Gets the members in the Base, Adapted, and Extended views.

基础示例:

# 1.检索计算机上运行的 Windows 时间服务的相关信息的属性
Get-Service -Name w32time | Get-Member
# TypeName 指示返回的对象类型。
# TypeName:System.ServiceProcess.ServiceController

# 知道命令生成的对象类型之后，就可以使用此信息查找接受该类型的对象作为输入的命令
Get-Command -ParameterType ServiceController
# CommandType     Name                                               Version    Source
# -----------     ----                                               -------    ------
# Cmdlet          Get-Service                                        3.1.0.0    Microsoft.PowerShell.Management
# Cmdlet          Restart-Service                                    3.1.0.0    Microsoft.PowerShell.Management
......

# 2.查看对象的静态方法
Get-Member -static -memberType *Method  

# 3.查看Get-Host 对象的属性以及方法
Host | Get-Member -MemberType Property 
     # Name             MemberType Definition
     # ----             ---------- ----------
     # CurrentCulture   Property   cultureinfo CurrentCulture {get;}
     # CurrentUICulture Property   cultureinfo CurrentUICulture {get;}
     # DebuggerEnabled  Property   bool DebuggerEnabled {get;set;}
     # InstanceId       Property   guid InstanceId {get;}
     # IsRunspacePushed Property   bool IsRunspacePushed {get;}
     # Name             Property   string Name {get;}
     # PrivateData      Property   psobject PrivateData {get;}
     # Runspace         Property   runspace Runspace {get;}
     # UI               Property   System.Management.Automation.Host.PSHostUserInterface UI {get;}
     # Version          Property   version Version {get;}
(Host).Version  # 以Version属性值获得PS版本
     # Major  Minor  Build  Revision
     # -----  -----  -----  --------
     # 5      1      19041  610

Host | Get-Member -MemberType Method
     # TypeName:System.Management.Automation.Internal.Host.InternalHost
     # Name                   MemberType Definition
     # ----                   ---------- ----------
     # EnterNestedPrompt      Method     void EnterNestedPrompt()
     # Equals                 Method     bool Equals(System.Object obj)
     # ExitNestedPrompt       Method     void ExitNestedPrompt()
     # GetHashCode            Method     int GetHashCode()
     # GetType                Method     type GetType()
     # .........
     # ToString               Method     string ToString()
(Host).GetHashCode();
     # 14844108


# 4.通过将 Get-Service 的结果通过管道传递到 Select-Object 并将 * 通配符指定为 Property 参数的值来选择所有属性或者进行制定。
Get-Service -Name TermService | Get-Member -MemberType Property
     # Status   Name               DisplayName
     # ------   ----               -----------
     # Running  TermService        Remote Desktop Services

(Get-Service -Name TermService).ServiceName
     # TermService
(Get-Service -Name TermService).DisplayName
     # Remote Desktop Services
(Get-Service -Name TermService).Status
     # Running

# 采用 Select-Object 命令搞定服务名称、描述、以及其状态
Get-Service -Name TermService | Select-Object -Property ServiceName,DisplayName,Status
# ServiceName DisplayName              Status
# ----------- -----------              ------
# TermService Remote Desktop Services Running


# 5.方法是可执行的操作
Get-Service -Name TermService | Get-Member -MemberType Method
# 例如 Stop 方法可用于停止 Windows 远程桌面服务。
(Get-Service -Name TermService).Stop()


# 6.使用 Start-Service cmdlet 指定 PassThru 参数，以使其生成输出，然后通过管道将输出传递到 Get-Member
Start-Service -Name w32time -PassThru | Get-Member
  # TypeName:System.ServiceProcess.ServiceController
  # Name                      MemberType    Definition
  # ----                      ----------    ----------
  # Name                      AliasProperty Name = ServiceName
  # RequiredServices          AliasProperty RequiredServices = ServicesDependedOn
  # Disposed                  Event         System.EventHandler Disposed(System.Object, System.EventArgs)
  # Close                     Method        void Close()


# 7.获取服务对象的扩展成员
# 描述: 此示例获取通过使用 `Types.ps1xml` 文件或 `Add Member` cmdlet扩展的服务对象的方法和属性。
$obj=New-Object PSObject
$d = [ordered]@{Name="Server";System="Server Core";PSVersion="4.0"}
$obj | Add-Member -NotePropertyMembers $d -TypeName Asset -PassThru -Force
$obj | Get-Member -View Extended
  #   TypeName:Asset
  # Name      MemberType   Definition
  # ----      ----------   ----------
  # Name      NoteProperty string Name=Server
  # PSVersion NoteProperty string PSVersion=4.0
  # System    NoteProperty string System=Server Core


# 8.此示例获取事件查看器中系统日志中事件日志对象的脚本属性。
Get-WinEvent -LogName System -MaxEvents 1 | Get-Member -View All
Get-WinEvent -LogName System -MaxEvents 1 | Select-Object -Property Id,LevelDisplayName,LogName,Message
  #    Id LevelDisplayName LogName Message
  #    -- ---------------- ------- -------
  #  7040 信息             System  Background Intelligent Transfer Service 服务的启动类型从 自动启动 更改为 按需启动。


# 9.接受从通道里面传递的对象也可以指定-InputObject参数接收。
$array = @(1,'hello')
$array | Get-Member             # 显示  TypeName:System.Int32 - TypeName:System.String
Get-Member -InputObject $array  # 显示  TypeName:System.Object[]

Tips : 许多初学者认为无法使用 Get-* 命令进行颠覆性更改。但是如果方法使用不当，也会带来严重后果。

Tips : 若要通过管道将命令传递到 Get-Member，命令必须生成基于对象的输出，例如以下命令是不行的 Get-Service -Name w32time | Out-Host | Get-Member，因为Out-Host 直接写入 PowerShell 主机，但它不会为管道生成基于对象的输出。因此无法通过管道将该命令传输到 Get-Member。。