Compartir a través de

Remove-SCGuestOSProfile

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de perfil de sistema operativo invitado de VMM.

Sintaxis

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCGuestOSProfile quita uno o varios objetos de perfil de sistema operativo invitado 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: Quitar un perfil de sistema operativo invitado específico de la biblioteca

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

El primer comando obtiene el objeto de perfil del sistema operativo invitado denominado NewOSProfile01 y almacena el objeto en la variable $OSProfile.

El segundo comando quita el perfil del sistema operativo invitado almacenado en $OSProfile, lo que solicita confirmación antes de completar la operación.

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

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

El primer comando obtiene todos los objetos de perfil del sistema operativo de VMMServer01 y almacena los objetos en la matriz de objetos $OSProfiles.

El segundo comando pasa cada objeto de $OSProfiles al cmdlet remove-OSProfile , que quita cada uno de los objetos de perfil del sistema operativo invitado de la biblioteca VMM.

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

-Force

Obliga a que el comando se ejecute sin pedir confirmación del usuario.

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

-GuestOSProfile

Especifica un objeto de perfil de sistema operativo invitado.

Tipo:GuestOSProfile
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 sistema operativo invitado VMM, que se puede recuperar mediante el cmdlet get-SCGuestOSProfile de .