Get-CMSupportedPlatform

Get a supported platform.

Syntax

Get-CMSupportedPlatform
   [-Fast]
   [-MaxVersion <String>]
   [-MinVersion <String>]
   [-Name <String>]
   [-Platform <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Get a supported platform. Configuration Manager maintains a list of supported platforms, which applies to various objects such as compliance policies, package programs, and task sequences. These objects only apply to devices with the specified platforms.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get all Windows 10 platforms by name

Get-CMSupportedPlatform -Name "*Windows*10*" -Fast

Example 2: Get all Windows 8 platforms by version

Get-CMSupportedPlatform -Fast -MinVersion "6.2*"

Example 3: Get all platforms

This example gets all supported platforms for the site, and only displays the name.

Get-CMSupportedPlatform -Fast | Select-Object DisplayText

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Fast

Add this parameter to not automatically refresh lazy properties. Lazy properties contain values that are relatively inefficient to retrieve. Getting these properties can cause additional network traffic and decrease cmdlet performance.

If you don't use this parameter, the cmdlet displays a warning. To disable this warning, set $CMPSSuppressFastNotUsedCheck = $true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxVersion

Filter the list of supported platforms by a specific maximum OS version. For example, "10.00.99999.9999".

You can use wildcard characters:

  • *: Multiple characters
  • ?: Single character
Type:String
Aliases:OSMaxVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-MinVersion

Filter the list of supported platforms by a specific maximum OS version. For example, "10.00.0000.0".

You can use wildcard characters:

  • *: Multiple characters
  • ?: Single character
Type:String
Aliases:OSMinVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

Filter the list of supported platforms by name. You can specify a specific platform name, for example, "All Windows 10 (64-bit)". You can also use wildcard characters:

  • *: Multiple characters
  • ?: Single character

For example, "*Windows*10*" for all Windows 10 platforms.

Type:String
Aliases:DisplayText
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Platform

Filter the list of supported platforms by OS platform. For example, "I386" or "x64".

Type:String
Aliases:OSPlatform
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Inputs

None

Outputs

IResultObject[]

IResultObject