Get-CMInventoriedSoftware

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Get-CMInventoriedSoftware

Gets Configuration Manager inventoried software product objects.

Syntax

Parameter Set: SearchByName
Get-CMInventoriedSoftware [-Name <String[]> ] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Get-CMInventoriedSoftware -Id <String[]> [ <CommonParameters>]

Detailed Description

The Get-CMInventoriedSoftware cmdlet gets inventoried software product objects. Microsoft System Center 2012 Configuration Manager can collect information about software contained on client devices. You can specify a software product by ID or name. You can use this cmdlet to get object to pass to other cmdlets, such as the Set-CMInventoriedSoftware cmdlet.

Parameters

-Id<String[]>

Specifies an array of IDs for inventoried software products.

Aliases

CategoryId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of names of inventoried software products. You can use a wildcard character.

Aliases

CommonName

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Examples

Example 1: Get software by using a name

This command gets all the inventoried software products that have names that start with Contoso Software.

PS C:\> Get-CMInventoriedSoftware -Name "Contoso Software*"

Example 2: Get software by using an ID

This command gets the inventoried software product that has the ID 1281.

PS C:\> Get-CMInventoriedSoftware -Id 1281

Set-CMInventoriedSoftware

Undo-CMInventoriedSoftware