列表视图 (Label)

此示例演示如何实现一个列表视图，该视图显示列表的每一行的自定义标签。 此列表视图显示由 Get-Service cmdlet 返回的 System.ServiceProcess.ServiceController 对象的属性。 有关列表视图组件的详细信息，请参阅 创建列表视图。

加载此格式设置文件

1. 将本主题的“示例”部分中的 XML 复制到文本文件中。

2. 保存该文本文件。 请务必将 format.ps1xml 扩展名添加到文件，以将其标识为格式化文件。

3. 打开 Windows PowerShell，并运行以下命令将格式化文件加载到当前会话中：Update-FormatData -PrependPath PathToFormattingFile。

此格式设置文件定义已由 Windows PowerShell 格式化文件定义的对象的显示。 运行 cmdlet 时，必须使用 PrependPath 参数，并且无法将此格式文件加载为模块。

演示

此格式设置文件演示了以下 XML 元素：

• 视图的 Name 元素。

• ViewSelectedBy 元素，用于定义视图显示的对象。

• ListControl 元素，用于定义视图显示的属性。

• ListItem 元素，用于定义列表视图行中显示的内容。

• Label 元素，用于定义列表视图行中显示的内容。

• PropertyName 元素，用于定义显示哪个属性。

示例

以下 XML 定义一个列表视图，该视图显示每行中的自定义标签。 在这种情况下，标签包含每个字母大写的属性名称和单词“property”。 在每个行中，将显示属性的名称后跟属性的值。

<Configuration>
  <ViewDefinitions>
    <View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <ListControl>
    <ListEntries>
      <ListEntry>
        <ListItems>
          <ListItem>
            <Label>NAME property</Label>
            <PropertyName>Name</PropertyName>
          </ListItem>
          <ListItem>
            <Label>DISPLAYNAME property</Label>
            <PropertyName>DisplayName</PropertyName>
          </ListItem>
          <ListItem>
            <Label>STATUS property</Label>
            <PropertyName>Status</PropertyName>
          </ListItem>
          <ListItem>
            <Label>SERVICETYPE property</Label>
            <PropertyName>ServiceType</PropertyName>
          </ListItem>
        </ListItems>
      </ListEntry>
    </ListEntries>
  </ListControl>
</View>

  </ViewDefinitions>
</Configuration>

以下示例演示加载此格式化文件后 Windows PowerShell 如何显示 System.ServiceProcess.ServiceController 对象。

Get-Service f*

NAME property        : Fax
DISPLAYNAME property : Fax
STATUS property      : Stopped
SERVICETYPE property : Win32OwnProcess

NAME property        : FCSAM
DISPLAYNAME property : Microsoft Antimalware Service
STATUS property      : Running
SERVICETYPE property : Win32OwnProcess

NAME property        : fdPHost
DISPLAYNAME property : Function Discovery Provider Host
STATUS property      : Stopped
SERVICETYPE property : Win32ShareProcess

NAME property        : FDResPub
DISPLAYNAME property : Function Discovery Resource Publication
STATUS property      : Running
SERVICETYPE property : Win32ShareProcess

NAME property        : FontCache
DISPLAYNAME property : Windows Font Cache Service
STATUS property      : Running
SERVICETYPE property : Win32ShareProcess

NAME property        : FontCache3.0.0.0
DISPLAYNAME property : Windows Presentation Foundation Font Cache 3.0.0.0
STATUS property      : Stopped
SERVICETYPE property : Win32OwnProcess

NAME property        : FSysAgent
DISPLAYNAME property : Microsoft Forefront System Agent
STATUS property      : Running
SERVICETYPE property : Win32OwnProcess

NAME property        : FwcAgent
DISPLAYNAME property : Firewall Client Agent
STATUS property      : Running
SERVICETYPE property : Win32OwnProcess

另请参阅

格式化文件的示例

编写 PowerShell 格式设置文件