处理命令输出

项目
04/04/2023

适用于：Exchange Server 2013

Exchange 命令行管理程序提供了可用来设置命令输出格式的多种方法。本主题介绍以下内容：

如何设置数据格式：如何使用 Format-List 、 Format-Table 和 Format-Wide cmdlet 控制数据的显示格式。
如何输出数据：使用 Out-Host 和 Out-File cmdlet 确定是将数据输出到命令行管理程序控制台窗口，还是输出到文件。本主题中包含一个示例脚本，用于将数据输出到 Microsoft Internet Explorer。
如何筛选数据：使用以下筛选方法之一来筛选数据：
- 服务器端筛选，在某些 cmdlet 中可用。
- 客户端筛选，在所有 cmdlet 中可用，方法是将命令结果通过管道传递给 Where-Object cmdlet。

若要使用本主题介绍的功能，必须了解以下概念：

如何设置数据格式

如果在管道末端调用格式设置 cmdlet，则可以覆盖默认格式，以控制显示的数据和数据显示方式。格式设置 cmdlet 有 Format-List 、 Format-Table 和 Format-Wide 。每一个 cmdlet 都有其不同于其他格式设置 cmdlet 的输出样式。

Format-List

Format-List cmdlet 接受来自管道的输入并将每个对象的所有指定属性以垂直列表格式输出。可以使用 Property 参数指定要显示的属性。如果调用 Format-List cmdlet 而未指定任何参数，则将输出所有属性。 Format-List cmdlet 会自动换行，而不是截断行。 Format-List cmdlet 的最佳用途之一就是覆盖某个 cmdlet 的默认输出，以便检索其他信息或更受关注的信息。

例如，调用 Get-Mailbox cmdlet 时，看到的只是以表格格式显示的有限信息量。如果将 Get-Mailbox cmdlet 的输出通过管道传递给 Format-List cmdlet，并添加针对需要查看的其他信息或更受关注信息的参数，则可检索所需的输出。

还可以使用通配符“*”指定部分属性名。如果包含通配符，则可以匹配多个属性，而不必分别键入每个属性名。例如， Get-Mailbox | Format-List -Property Email* 返回以 Email开头的所有属性。

以下示例显示用不同方式查看 Get-Mailbox cmdlet 返回的相同数据。

Get-Mailbox TestUser1

Name                      Alias                ServerName       ProhibitSendQuota
----                      -----                ----------       ---------------
TestUser1                 TestUser1            mbx              unlimited

在第一个示例中，调用 Get-Mailbox cmdlet 但未指定格式，因此，默认输出为表格格式并包含一组预定义的属性。

Get-Mailbox TestUser1 | Format-List -Property Name,Alias,EmailAddresses

Name           : TestUser1
Alias          : TestUser1
EmailAddresses : {SMTP:TestUser1@contoso.com}

在第二个示例中，将 Get-Mailbox cmdlet 的输出连同其特定属性通过管道传递给 Format-List cmdlet。可以看到，输出的格式和内容有明显不同。

Get-Mailbox TestUser1 | Format-List -Property Name, Alias, Email*
Name                      : Test User
Alias                     : TestUser1
EmailAddresses            : {SMTP:TestUser1@contoso.com}
EmailAddressPolicyEnabled : True

在最后一个示例中，与第二个示例相同，将 Get-Mailbox cmdlet 的输出通过管道传递给了 Format-List cmdlet。但是，在最后一个示例中，通配符用于匹配以 Email开头的所有属性。

如果有多个对象传递到 Format-List cmdlet，则为每个对象指定的所有属性都将显示并按对象进行分组。显示顺序取决于该 cmdlet 的默认参数。默认参数通常为 Name 参数或 Identity 参数。例如，调用 Get-Childitem cmdlet 时，默认显示顺序是文件名按字母顺序排列。若要更改此行为，必须调用 Format-List cmdlet 以及 GroupBy 参数以及要对其输出进行分组的属性值的名称。例如，以下命令将列出目录中的所有文件，并将这些文件按文件扩展名进行分组。

Get-Childitem | Format-List Name,Length -GroupBy Extension

Extension: .xml

Name   : Config_01.xml
Length : 5627

Name   : Config_02.xml
Length : 3901

Extension: .bmp

Name   : Image_01.bmp
Length : 746550

Name   : Image_02.bmp
Length : 746550

Extension: .txt

Name   : Text_01.txt
Length : 16822

Name   : Text_02.txt
Length : 9835

在此示例中，Format-List cmdlet 已按 GroupBy 参数指定的 Extension 属性对项进行分组。可以将 GroupBy 参数与管道流中对象的任一有效属性结合使用。

Format-Table

可以使用 Format-Table cmdlet 以表格格式显示项目，其中包含标签标题和属性数据列。默认情况下，许多 cmdlet（如 Get-Process 和 Get-Service cmdlet）都使用表格格式输出。 Format-Table cmdlet 的参数包括 Properties 和 GroupBy 参数。这些参数的作用与其在 Format-List cmdlet 中的作用完全相同。

Format-Table cmdlet 还使用 Wrap 参数。此参数可以完全显示较长的属性信息行，不会在行的末尾截断。若要查看 Wrap 参数如何 用于显示返回的信息，请比较以下两个示例中 Get-Command 命令的输出。

在第一个示例中，当 Get-Command cmdlet 用于显示有关 Get-Process cmdlet 的命令信息时， Definition 属性的信息将被截断。

Get-Command Get-Process | Format-Table Name,Definition

Name                                    Definition
----                                    ----------
get-process                             get-process [[-ProcessName] String[]...

第二个示例将 Wrap 参数添加到命令，以强制显示 Definition 属性的完整内容。

Get-Command Get-Process | Format-Table Name,Definition -Wrap

Get-Process                             Get-Process [[-Name] <String[]>] [-Comp
                                        uterName <String[]>] [-Module] [-FileVe
                                        rsionInfo] [-Verbose] [-Debug] [-ErrorA
                                        ction <ActionPreference>] [-WarningActi
                                        on <ActionPreference>] [-ErrorVariable
                                        <String>] [-WarningVariable <String>] [
                                        -OutVariable <String>] [-OutBuffer <Int
                                            32>]
                                        Get-Process -Id <Int32[]> [-ComputerNam
                                        e <String[]>] [-Module] [-FileVersionIn
                                        fo] [-Verbose] [-Debug] [-ErrorAction <
                                        ActionPreference>] [-WarningAction <Act
                                        ionPreference>] [-ErrorVariable <String
                                        >] [-WarningVariable <String>] [-OutVar
                                        iable <String>] [-OutBuffer <Int32>]
                                        Get-Process [-ComputerName <String[]>]
                                        [-Module] [-FileVersionInfo] -InputObje
                                        ct <Process[]> [-Verbose] [-Debug] [-Er
                                        rorAction <ActionPreference>] [-Warning
                                        Action <ActionPreference>] [-ErrorVaria
                                        ble <String>] [-WarningVariable <String
                                        >] [-OutVariable <String>] [-OutBuffer
                                        <Int32>]

与 Format-List cmdlet 一样，还可以使用部分属性名称指定通配符“*”。通过包含通配符，可以匹配多个属性，而不必分别键入每个属性名。

Format-Wide

Format-Wide cmdlet 提供比其他格式 cmdlet 都更简单的输出控制。默认情况下， Format-Wide cmdlet 尝试在一个输出行显示尽可能多的属性值列。通过添加参数，可以控制列数以及输出空间的使用方式。

最基本的用法是，不使用任何参数调用 Format-Wide cmdlet，使输出按适合页面大小的列数进行排列。例如，如果运行 Get-Childitem cmdlet 并将其输出通过管道传递给 Format-Wide cmdlet，则信息将如下显示：

Get-ChildItem | Format-Wide

Directory: FileSystem::C:\WorkingFolder

Config_01.xml                           Config_02.xml
Config_03.xml                           Config_04.xml
Config_05.xml                           Config_06.xml
Config_07.xml                           Config_08.xml
Config_09.xml                           Image_01.bmp
Image_02.bmp                            Image_03.bmp
Image_04.bmp                            Image_05.bmp
Image_06.bmp                            Text_01.txt
Text_02.txt                             Text_03.txt
Text_04.txt                             Text_05.txt
Text_06.txt                             Text_07.txt
Text_08.txt                             Text_09.txt
Text_10.txt                             Text_11.txt
Text_12.txt

通常，不使用任何参数调用 Get-Childitem cmdlet 时，将会在一个属性表格中显示目录中所有文件的名称。在本示例中，将 Get-Childitem cmdlet 的输出通过管道传递给 Format-Wide cmdlet，输出将以两列名称显示。请注意，一次只能显示一种属性类型，该类型由接在 Format-Wide cmdlet 后的属性名称指定。如果添加 Autosize 参数，输出将从两列更改为适合屏幕宽度的任意多列。

Get-ChildItem | Format-Wide -AutoSize

Directory: FileSystem::C:\WorkingFolder

Config_01.xml   Config_02.xml   Config_03.xml   Config_04.xml   Config_05.xml
Config_06.xml   Config_07.xml   Config_08.xml   Config_09.xml   Image_01.bmp
Image_02.bmp    Image_03.bmp    Image_04.bmp    Image_05.bmp    Image_06.bmp
Text_01.txt     Text_02.txt     Text_03.txt     Text_04.txt     Text_05.txt
Text_06.txt     Text_07.txt     Text_08.txt     Text_09.txt     Text_10.txt
Text_11.txt     Text_12.txt

在本示例中，表格按五列排列，而不是两列。 Column 参数通过指定显示信息的最大列数，提供更多控制，如下所示：

Get-ChildItem | Format-Wide -Column 4

Directory: FileSystem::C:\WorkingFolder

Config_01.xml       Config_02.xml       Config_03.xml       Config_04.xml
Config_05.xml       Config_06.xml       Config_07.xml       Config_08.xml
Config_09.xml       Image_01.bmp        Image_02.bmp        Image_03.bmp
Image_04.bmp        Image_05.bmp        Image_06.bmp        Text_01.txt
Text_02.txt         Text_03.txt         Text_04.txt         Text_05.txt
Text_06.txt         Text_07.txt         Text_08.txt         Text_09.txt
Text_10.txt         Text_11.txt         Text_12.txt

在本示例中，使用 Column 参数将列数强制限制为四列。

如何输出数据

Out-Host 和 Out-File cmdlet

Out-Host cmdlet 是管道末端一个不可见的默认 cmdlet。应用了所有格式之后， Out-Host cmdlet 将最终输出发送到控制台窗口进行显示。 Out-Host cmdlet 是默认输出，因此无需显式调用。通过将调用 Out-File cmdlet 作为命令中最后一个 cmdlet，可以取代将输出发送到控制台窗口的操作。 Out-File cmdlet 则将输出写入到命令中指定的文件，如下例所示：

Get-ChildItem | Format-Wide -Column 4 | Out-File c:\OutputFile.txt

在此示例中， Out-File cmdlet 将 Get-ChildItem | Format-Wide -Column 4 命令中显示的信息写入名为 OutputFile.txt的文件。还可以使用重定向运算符（右尖括号 () > ）将管道输出重定向到文件。若要将命令的管道输出追加到现有文件而不替换原始文件，请使用双右尖括号 ( >> ) ，如以下示例所示：

Get-ChildItem | Format-Wide -Column 4 >> C:\OutputFile.txt

在此示例中， Get-Childitem cmdlet 的输出通过管道传输到 Format-Wide cmdlet 进行格式设置，然后写入文件末尾 OutputFile.txt 。请注意， OutputFile.txt 如果文件不存在，则使用双右尖括号 ( >> ) 将创建该文件。

有关管道的详细信息，请参阅 about_Pipelines。

有关以上示例中所用语法的详细信息，请参阅Syntax。

在 Internet Explorer 中查看数据

由于在 Exchange 命令行管理程序中可以灵活简便地编写脚本，因此可以接受命令返回的数据，并以几乎无限制的方式设置其格式并输出。

以下示例说明如何使用一个简单脚本输出某个命令返回的数据，并在 Internet Explorer 中显示。此脚本接受通过管道传递的对象，打开 Internet Explorer 窗口，然后在 Internet Explorer 中显示数据：

$Ie = New-Object -Com InternetExplorer.Application
$Ie.Navigate("about:blank")
While ($Ie.Busy) { Sleep 1 }
$Ie.Visible = $True
$Ie.Document.Write("$Input")
# If the previous line doesn't work on your system, uncomment the line below.
# $Ie.Document.IHtmlDocument2_Write("$Input")
$Ie

若要使用此脚本，请将其保存到 C:\Program Files\Microsoft\Exchange Server\V15\Scripts 将运行脚本的计算机上的目录中。将文件 Out-Ie.ps1命名为。保存文件后，即可将脚本作为普通 cmdlet 使用。

注意

若要在 Exchange 2013 中运行脚本，必须将脚本添加到无作用域的管理角色，而且您必须已直接获得或通过管理角色组获得管理角色。有关详细信息，请参阅了解管理角色。

脚本 Out-Ie 假定它接收的数据是有效的 HTML。若要将要查看的数据转换为 HTML 格式，必须将命令的结果通过管道传递给 ConvertTo-Html cmdlet。然后，可以通过管道将命令的结果传递给 Out-Ie 脚本。以下示例说明了如何在 Internet Explorer 窗口中查看目录列表：

Get-ChildItem | Select Name,Length | ConvertTo-Html | Out-Ie

如何筛选数据

命令行管理程序使您能够访问有关组织中的服务器、邮箱、Active Directory 以及其他对象的大量信息。虽然访问这些信息有助于更好地了解所处的环境，但是海量信息可能会令您不知所措。命令行管理程序使您能够控制这些信息，并通过使用筛选只返回需要查看的数据。以下筛选类型可用：

服务器端筛选：服务器端筛选采用你在命令行中指定的筛选器，并将其提交到你查询的 Exchange 服务器。该服务器处理查询，并且只返回与指定的筛选器匹配的数据。

仅针对那些可能返回数万或数十万结果的对象执行服务器端筛选。因此，只有收件人管理 cmdlet（如 Get-Mailbox cmdlet）和查询管理 cmdlet（如 Get-Queue cmdlet）才支持服务器端筛选。这些 cmdlet 支持 Filter 参数。此参数接受指定的筛选器表达式，并将其提交给服务器进行处理。
客户端筛选：对当前正在使用的本地控制台窗口中的对象执行客户端筛选。使用客户端筛选时，该 cmdlet 检索与正在执行的任务匹配的所有对象，并提交到本地控制台窗口中。然后，命令行管理程序接受所有返回的结果，对这些结果应用客户端筛选，并且只返回与筛选器匹配的结果。所有 cmdlet 都支持客户端筛选。将命令结果通过管道传递给 Where-Object cmdlet 可调用此筛选。

服务器端筛选

服务器端筛选的实现特定于它所支持的 cmdlet。仅针对返回的对象上的特定属性启用服务器端筛选。有关详细信息，请参阅以下 cmdlet 的帮助：


Get-ActiveSyncDevice	Get-ActiveSyncDeviceClass	Get-CASMailbox	Get-Contact	Get-DistributionGroup
Get-DynamicDistributionGroup	Get-Group	Get-Mailbox	Get-MailboxStatistics	Get-MailContact
Get-MailPublicFolder	Get-MailUser	Get-Message	Get-MobileDevice	Get-Queue
Get-QueueDigest	Get-Recipient	Get-RemoteMailbox	Get-RoleGroup	Get-SecurityPrincipal
Get-StoreUsageStatistics	Get-UMMailbox	Get-User	GetUserPhoto	Remove-Message
Resume-Message	Resume-Queue	Retry-Queue	Suspend-Message	Suspend-Queue

客户端筛选

客户端筛选可以与任何 cmdlet 一起使用。此功能包含那些同样支持服务器端筛选的 cmdlet。本主题前面部分已介绍，客户端筛选接受管道中上一个命令返回的所有数据，但只返回与指定筛选器匹配的结果。 Where-Object cmdlet 可执行此筛选。该 cmdlet 可缩写为 Where 。

数据通过管道传递时， Where cmdlet 收到上一个对象的数据，然后将数据筛选后传递到下一个对象。该筛选基于 Where 命令中定义的脚本块。该脚本块根据对象的属性和值来筛选数据。

Clear-Host cmdlet 用于清除控制台窗口。在本示例中，如果运行以下命令，则可以找到为 Clear-Host cmdlet 定义的所有别名：

Get-Alias | Where {$_.Definition -eq "Clear-Host"}

CommandType     Name                            Definition
-----------     ----                            ----------
Alias           clear                           clear-host
Alias           cls                             clear-host

Get-Alias cmdlet 与 Where 命令一起使用，可以返回为 Clear-Host cmdlet 定义的别名列表，无需其他 cmdlet。下表列出了本示例中使用的 Where 命令的每个元素。

Where 命令的元素

元素	说明
`{ }`	一对大括号，用于括起定义筛选器的脚本块。
`$_`	此特殊变量可自动启动并绑定到管道中的对象。
`Definition`	属性 `Definition` 是存储别名定义名称的当前管道对象的属性。当与变量一起使用`$_`时`Definition`，属性名称前面有一个句点。
`-eq`	"等于"比较运算符，用于指定结果必须与表达式中提供的属性值完全匹配。
“Clear-Host”	在本示例中，“Clear-Host”是命令要分析的值。

在本示例中， Get-Alias cmdlet 返回的对象代表系统中所有已定义的别名。即使从命令行看不到这些别名，它们也会被收集并通过管道传递给 Where cmdlet。 Where cmdlet 使用脚本块中的信息对这些别名对象应用筛选器。

特殊变量 $_represents传递的对象。变量 $_由 Shell 自动启动，并绑定到当前管道对象。有关此特殊变量的详细信息，请参阅 Shell 变量。

使用标准“点”表示法 (object.property) ， Definition 添加属性以定义要计算的对象的确切属性。然后，比较 -eq 运算符将此属性的值与进行比较 "Clear-Host"。只有具有与此条件匹配的 Definition 属性的对象才会传递到控制台窗口进行输出。有关比较运算符的详细信息，请参阅比较运算符。

Where 命令筛选了由 Get-Alias cmdlet 返回的对象之后，您可以将筛选的对象通过管道传递给另一个命令。下一个命令将只处理这些由 Where 命令返回的已筛选对象。

通过