Select-PSFPropertyValue
SYNOPSIS
Expand specific property values based on selection logic.
SYNTAX
Default (Default)
Select-PSFPropertyValue [-Property] <String[]> [-InputObject <Object>] [<CommonParameters>]
Fallback
Select-PSFPropertyValue [-Property] <String[]> [-Fallback] [-InputObject <Object>] [<CommonParameters>]
Select
Select-PSFPropertyValue [-Property] <String[]> [-Select <String>] [-InputObject <Object>] [<CommonParameters>]
Join
Select-PSFPropertyValue [-Property] <String[]> [-JoinBy <String>] [-InputObject <Object>] [<CommonParameters>]
Format
Select-PSFPropertyValue [-Property] <String[]> [-FormatWith <String>] [-InputObject <Object>]
[<CommonParameters>]
DESCRIPTION
This command allows picking a set of properties and then returning …
- All their values
- The value that meets specific rules
- A composite value
EXAMPLES
EXAMPLE 1
Get-ADComputer -Filter * | Select-PSFPropertyValue -Property 'DNSHostName', 'Name' -Fallback
For each computer in the domain, it will pick the DNSHostName if available, otherwise the Name.
PARAMETERS
-Property
The properties to work with, in the order they should be considered.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fallback
Whether to fall back on other properties if the first one doesn’t contain values. This picks the value of the first property that actually has a value.
Type: SwitchParameter
Parameter Sets: Fallback
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Select
Select either the largest or lowest propertyvalue in the Propertynames specified.
Type: String
Parameter Sets: Select
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-JoinBy
Joins the selected properties by the string specified.
Type: String
Parameter Sets: Join
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FormatWith
Formats the selected properties into the specified format string.
Type: String
Parameter Sets: Format
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
The object(s) whose properties to inspect.
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.