Share via

Remove-SCSPFVMRoleGalleryItem

Module:
spfadmin Module

Removes an item from the gallery.

Syntax

FromGalleryItemParameterSetName (Default) 

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

FromGalleryItemNameVersionPublisherParameterSetName 

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

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.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the publisher of the gallery item to remove.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromGalleryItemNameVersionPublisherParameterSetName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Publisher

Specifies the publisher of the item to remove.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromGalleryItemNameVersionPublisherParameterSetName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Version

Specifies the version of the item to remove.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromGalleryItemNameVersionPublisherParameterSetName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMRoleGalleryItem

Specifies one or more gallery items to remove.

Parameter properties

Type:

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

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

FromGalleryItemParameterSetName
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

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

Outputs

System.Object