Remove-SCGuestOSProfile

  • Referencia
Módulo:
VirtualMachineManager

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

Syntax

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 tras la operación correcta (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 y solicita confirmación antes de completar la operación.

Ejemplo 2: Quitar todos los perfiles del 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 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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-GuestOSProfile

Especifica un objeto del perfil de sistema operativo invitado.

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