Undo-CMInventoriedSoftware

Article
11/02/2012

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

Undo-CMInventoriedSoftware

Undoes changes to an inventoried software item in Configuration Manager.

Syntax

Parameter Set: SearchByNameMandatory
Undo-CMInventoriedSoftware -Name <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIDMandatory
Undo-CMInventoriedSoftware -Id <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Undo-CMInventoriedSoftware -InventoriedSoftware <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Undo-CMInventoriedSoftware cmdlet undoes the last change to an inventoried software product.

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 or use the Get-CMInventoriedSoftware cmdlet to obtain an inventoried software object.

This cmdlet undoes changes done in System Center 2012 Configuration Manager, not changes to the software installed on client systems.

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

-InventoriedSoftware<IResultObject>

Specifies an inventoried software object. To obtain an inventories software object, use the Get-CMInventoriedSoftware cmdlet.

Aliases	none
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.

Aliases	CommonName
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	True (ByPropertyName)
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Required?	false
Position?	named
Default Value	false
Accept Pipeline Input?	false
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: Undo changes to a software product

This command undoes the last change to an inventoried software product called Contoso Network 4.

PS C:\> Undo-CMInventoriedSoftware -Name "Contoso Network 4"

Example 2: Undo changes to several software products

This example undoes the changes for several inventoried software products.

The first command gets all the inventoried software products that have names that start with Contoso Software and saves them in the $CMIS variable.

The second command undoes the last change for the items stored in $CMIS.

PS C:\> $CMIS = Get-CMInventoriedSoftware -Name "Contoso Software*"
PS C:\>Undo-CMInventoriedSoftware -InventoriedSoftware $CMIS

Get-CMInventoriedSoftware

Set-CMInventoriedSoftware

Undo-CMInventoriedSoftware