Remove-SCHardwareProfile

  • Referencia
Módulo:
VirtualMachineManager

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

Sintaxis

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 ejecuta correctamente con la propiedad MarkedForDeletion establecida en $True, o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Eliminación de 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 que confirme 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 pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HardwareProfile

Especifica un objeto de perfil de hardware.

Tipo:HardwareProfile
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Notas

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