Remove-SCSPFVMRoleGalleryItem

Reference

Module:: spfadmin

Removes an item from the gallery.

Syntax

Remove-SCSPFVMRoleGalleryItem
      [-VMRoleGalleryItem] <VMRoleGalleryItem[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-SCSPFVMRoleGalleryItem
      -Name <String>
      -Version <String>
      -Publisher <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-SCSPFVMRoleGalleryItem cmdlet removes a gallery item from the vmm12sp1_long or the Service Provider Foundation database.

Examples

Example 1: Remove a gallery item

PS C:\>$Item = Get-SCSPFVMRoleGalleryItem -Name "570569955cbfb62b374358b34467
020750f65c"
PS C:\> Remove-SCSPFVmRoleGalleryItem -VMRoleGalleryItem $Item

The first command gets an item by name and stores it in the $Item variable. The next command removes the item.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	System.Management.Automation.SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifies the publisher of the gallery item to remove.

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

-Publisher

Specifies the publisher of the item to remove.

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

-Version

Specifies the version of the item to remove.

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

-VMRoleGalleryItem

Specifies one or more gallery items to remove.

Type:	Microsoft.SystemCenter.Foundation.SPFData.Types.Gallery.VMRoleGalleryItem[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	System.Management.Automation.SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.SystemCenter.Foundation.SPFData.Types.Gallery.VMRoleGalleryItem[]

Outputs

System.Object