Remove-SCISO

  • Referencia
Módulo:
VirtualMachineManager

Quita un archivo ISO de la biblioteca VMM.

Syntax

Remove-SCISO
      [-ISO] <ISO>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCISO quita un archivo ISO de la biblioteca de Virtual Machine Manager (VMM) y elimina el archivo ISO en el servidor de biblioteca.

Si la ISO está asociada a una máquina virtual, plantilla o perfil de hardware y, si no especifica el parámetro Force , VMM enumera el contenedor que incluye la ISO y le pide que confirme que desea quitar la ISO:

  • Si responde Sí, VMM quita la asociación entre la ISO y el contenedor al que está asociado y, a continuación, elimina el objeto ISO de VMM.

  • Si responde No, se cancela la operación.

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 objeto ISO y eliminar el archivo .iso correspondiente

PS C:\> $ISO = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCISO -ISO $ISO

El primer comando obtiene el objeto ISO denominado OsISO.iso de LibraryServer01 y almacena el objeto ISO en la variable $ISO.

El segundo comando quita el objeto ISO de la biblioteca y elimina el archivo .iso correspondiente del sistema de archivos del servidor de biblioteca.

Ejemplo 2: Eliminación de varios objetos ISO de la biblioteca

PS C:\> $ISOs = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "OsISO" }
PS C:\> $ISOs | Remove-SCISO

El primer comando obtiene todos los objetos ISO cuyo nombre incluye la cadena "OsISO" y almacena estos objetos ISO en la variable $ISOs.

El segundo comando pasa cada objeto ISO de $ISOs al cmdlet Remove-SCISO , que quita cada objeto ISO de la biblioteca y elimina el archivo .iso correspondiente del sistema de archivos del servidor de bibliotecas.

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

-ISO

Especifica un objeto ISO.

Type:ISO
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 de optimización de recursos y rendimiento (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 inmediatamente al shell de comandos.

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 ISO VMM, que se puede recuperar mediante el cmdlet Get-SCISO .