Remove-SCSPFVMRoleGalleryItem
Applies To: System Center 2012 R2 Orchestrator
Remove-SCSPFVMRoleGalleryItem
Removes an item from the gallery.
Syntax
Parameter Set: FromGalleryItemParameterSetName
Remove-SCSPFVMRoleGalleryItem [-Name] <String> [-Version] <VMRoleGalleryItem[]> [-VMRoleGalleryItem] <VMRoleGalleryItem[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-SCSPFVMRoleGalleryItem cmdlet removes a gallery item from VMM and the Service Provider Foundation database.
Parameters
-VMRoleGalleryItem<VMRoleGalleryItem[]>
Specifies one or more gallery items to be removed.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the publisher of the gallery item to be removed.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Version<VMRoleGalleryItem[]>
Specifies the version of the item to be removed.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
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.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
1: Remove a gallery item
The first command gets an item by its name and stores it in the $oldItem variable. The next commend removes the item.
PS C:\> $oldItem = Get-SCSPFVMRoleGalleryItem -Name 570569955cbfb62b374358b34467
020750f65c
PS C:\> Remove-SCSPFVmRoleGalleryItem -VMRoleGalleryItem $oldItem