Compartir a través de

Remove-SCScript

  • Referencia
Módulo:
VirtualMachineManager

Quita un objeto de script de VMM.

Sintaxis

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 perfil de hardware (y si no usa el parámetro Force), Virtual Machine Manager (VMM) enumera 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 tras éxito (con la propiedad MarkedForDeletion establecida en $True) o devuelve un mensaje de error tras un error.

Ejemplos

Ejemplo 1: Quitar un objeto de script y eliminar el 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 existe más de un 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 de $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 del servidor de biblioteca.

Ejemplo 2: Quitar 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 de $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 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

-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

-Script

Especifica un objeto de script VMM.

Tipo:Script
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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