Remove-SCScript

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de script de VMM.

Syntax

Remove-SCScript
      [-Script] <Script>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCScript quita uno o varios objetos de script de la biblioteca VMM y elimina el archivo de script correspondiente en el servidor de biblioteca.

Si el script está asociado a una plantilla o un perfil de hardware (y si no usa el parámetro Force ), Virtual Machine Manager (VMM) muestra el contenedor que contiene el script y le pide que confirme que desea quitar el script:

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

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: Eliminación de un objeto de script y eliminación del archivo de script correspondiente

PS C:\> $Scripts = @(Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1"} )
PS C:\> $Scripts.Count
PS C:\> $Scripts | select Name,SharePath | Format-List
PS C:\> Remove-SCScript -Script $Scripts[0] -Force

El primer comando obtiene el objeto de script denominado AddHost.ps1 de la biblioteca VMM en VMMServer01 y almacena el objeto en la matriz denominada $Scripts. Es posible que exista más de un archivo con el mismo nombre si hay más de contenedor para scripts en el servidor de biblioteca especificado.

El segundo comando cuenta el número de scripts en $Scrips y muestra los resultados al usuario.

El tercer comando pasa cada objeto de script en $Scripts al cmdlet Select-Object, que selecciona el nombre y comparte la ruta de acceso de cada script de la matriz. A continuación, el comando pasa estos resultados al cmdlet Format-List para mostrar cada nombre de script y su ruta de acceso de recurso compartido al usuario.

El último comando elimina el primer objeto de la matriz $Scripts y usa el parámetro Force para asegurarse de que el objeto de script se quita de la base de datos VMM y el archivo de script correspondiente se elimina del sistema de archivos en el servidor de biblioteca.

Ejemplo 2: Eliminación de varios scripts de la biblioteca

PS C:\> $Scripts = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Sysprep" }
PS C:\> $Scripts | Remove-SCScript -Confirm

El primer comando obtiene todos los objetos de script cuyos nombres incluyen la cadena "Sysprep" de VMMServer01 y, a continuación, almacena estos objetos en la matriz denominada $Scripts.

El segundo comando pasa cada objeto de script en $Scripts a Remove-SCScript, que quita cada objeto de script de la biblioteca y elimina cada archivo de script correspondiente del sistema de archivos en el servidor de biblioteca.

El parámetro Confirm le pide que confirme que desea quitar estos scripts. Tiene la opción de confirmar la eliminación de todos los scripts a la vez o para confirmar la eliminación de cada script uno a uno.

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

-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

-Script

Especifica un objeto de script de Virtual Machine Manager.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
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