Compartir a través de

Remove-SCHardwareProfile

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de perfil de hardware de la biblioteca VMM.

Syntax

Remove-SCHardwareProfile
      [-HardwareProfile] <HardwareProfile>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCHardwareProfile quita uno o varios objetos de perfil de hardware de la biblioteca VMM.

Este cmdlet devuelve el objeto cuando se ha realizado correctamente con la propiedad MarkedForDeletion establecida en $True o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Quitar un perfil de hardware específico de la biblioteca

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01"}
PS C:\> Remove-SCHardwareProfile -HardwareProfile $HWProfile -Confirm

El primer comando obtiene el objeto de perfil de hardware denominado NewHWProfile01 de la biblioteca VMM y almacena el objeto en la variable $HWProfile.

El segundo comando elimina NewHWProfle01 de la biblioteca y solicita al usuario confirmación antes de completar la operación.

Ejemplo 2: Quitar todos los perfiles de hardware sin que se le pida que confirme cada eliminación

PS C:\> Get-SCHardwareProfile | Remove-SCHardwareProfile

Este comando obtiene todos los objetos de perfil de hardware de la biblioteca y pasa cada objeto de perfil al cmdlet Remove-SCHardwareProfile , que quita cada perfil de hardware. Al no usar el parámetro Confirm , no se le pedirá que confirme si desea eliminar estos objetos de perfil de hardware.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HardwareProfile

Especifica un objeto de perfil de hardware.

Type:HardwareProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-PROTipID

Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notas

  • Requiere un objeto de perfil de hardware VMM, que se puede recuperar mediante el cmdlet Get-SCHardwareProfile .