about_Hidden
SHORT DESCRIPTION
Describes the Hidden keyword, which hides class members from default Get-Member results.
LONG DESCRIPTION
When you use the Hidden keyword in a script, you hide the members of a class by default. The Hidden keyword can hide properties, methods (including constructors, events, alias properties, and other member types, including static members, from the default results of the Get-Member cmdlet, and from IntelliSense and tab completion results. To display members that you have hidden with the Hidden keyword, add the -Force parameter to a Get-Member command.
Hidden members are not displayed by using tab completion or IntelliSense, unless the completion occurs in the class that defines the hidden member.
A new attribute, System.Management.Automation.HiddenAttribute, has been added, so that C# code can have the same semantics within PowerShell.
The Hidden keyword is useful for creating properties and methods within a class that you do not necessarily want other users of the class to see, or readily be able to edit.
The Hidden keyword has no effect on how you can view or make changes to members of a class. Like all language keywords in PowerShell, Hidden is not case-sensitive, and hidden members are still public.
Hidden, along with custom classes, was introduced in PowerShell 5.0.
EXAMPLE
The following example shows how to use the Hidden keyword in a class definition. The Car class method, Drive, has a property, rides, that does not need to be viewed or changed (it merely tallies the number of times that Drive is called on the Car class, a metric that is not important to users of the class; consider, for example, that when you are buying a car, you do not ask the seller on how many drives the car has been taken.
Because there is little need for users of the class to change this property, we can hide the property from Get-Member and automatic completion results by using the Hidden keyword.
Add the Hidden keyword by entering it on the same statement line as the property and its data type. Although the keyword can be in any order on this line, starting the statement with the Hidden keyword makes it easier for you later to identify all members that you have hidden.
class Car
{
# Properties
[String] $Color
[String] $ModelYear
[int] $Distance
# Method
[int] Drive ([int]$miles)
{
$this.Distance += $miles
$this.rides++
return $this.Distance
}
# Hidden property of the Drive method
hidden [int] $rides = 0
}
Now, create a new instance of the Car class, and save it in a variable, $TestCar.
$TestCar = [Car]::new()
After you create the new instance, pipe the contents of the $TestCar variable to Get-Member. Observe that the rides property is not among the members listed in the Get-Member command results.
PS C:\Windows\system32> $TestCar | Get-Member
TypeName: Car
Name MemberType Definition
---- ---------- ----------
Drive Method int Drive(int miles)
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Color Property string Color {get;set;}
Distance Property int Distance {get;set;}
ModelYear Property string ModelYear {get;set;}
Now, try running Get-Member again, but this time, add the -Force parameter. Note that the results contain the hidden rides property, among other members that are hidden by default.
PS C:\Windows\system32> $TestCar | Get-Member -Force
TypeName: Car
Name MemberType Definition
---- ---------- ----------
pstypenames CodeProperty System.Collections.ObjectModel.Collection`1
psadapted MemberSet psadapted {Color, ModelYear, Distance,
psbase MemberSet psbase {Color, ModelYear, Distance,...
psextended MemberSet psextended {}
psobject MemberSet psobject {BaseObject, Members,...
Drive Method int Drive(int miles)
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
get_Color Method string get_Color()
get_Distance Method int get_Distance()
get_ModelYear Method string get_ModelYear()
get_rides Method int get_rides()
set_Color Method void set_Color(string )
set_Distance Method void set_Distance(int )
set_ModelYear Method void set_ModelYear(string )
set_rides Method void set_rides(int )
ToString Method string ToString()
Color Property string Color {get;set;}
Distance Property int Distance {get;set;}
ModelYear Property string ModelYear {get;set;}
rides Property int rides {get;set;}