propertyname-element-for-groupby-format.md

description	PropertyName Element for GroupBy
ms.date	08/24/2021
title	PropertyName Element for GroupBy

PropertyName Element for GroupBy

Specifies the .NET property that starts a new group whenever its value changes.

Schema

• Configuration Element
• ViewDefinitions Element
• View Element
• GroupBy Element
• PropertyName Element

Syntax

<PropertyName>.NetTypeProperty</PropertyName>

Attributes and Elements

The following sections describe attributes, child elements, and the parent element of the PropertyName element.

Attributes

None.

Child Elements

None.

Parent Elements

Element	Description
GroupBy Element for View	Defines how a group of .NET objects is displayed.

Text Value

Specify the .NET property name.

Remarks

Windows PowerShell starts a new group whenever the value of this property changes.

When this element is specified, you cannot specify the ScriptBlock element to start a new group.

Example

The following example shows how to start a new group when the value of a property changes.

<GroupBy>
  <Label>Service Type</Label>
  <PropertyName>ServiceType</PropertyName>
</GroupBy>

For an example of a complete formatting file that includes this element, see Wide View (GroupBy).

See Also

GroupBy Element for View

ScriptBlock Element for GroupBy

Writing a PowerShell Formatting File