Compartir a través de

Set-SCScript

  • Referencia
Módulo:
VirtualMachineManager

Cambia las propiedades de un script almacenado en la biblioteca VMM.

Sintaxis

Set-SCScript
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Script] <Script>
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCScript
   [-VMMServer <ServerConnection>]
   [-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet set-SCScript cambia una o varias propiedades de un script almacenado en la biblioteca de Virtual Machine Manager (VMM).

Entre las propiedades que puede cambiar se incluyen:

  • Descripción
  • Habilitado
  • Nombre
  • Dueño
  • SharePath

Los objetos de script representan archivos de script almacenados en un recurso compartido de biblioteca en un servidor de biblioteca. Normalmente, estos scripts son scripts de Windows PowerShell® o archivos de respuesta (como sysprep.inf o un archivo de Unattend.xml) que contienen las entradas necesarias para el programa de instalación de Windows.

Ejemplos

Ejemplo 1: Cambiar la descripción de un script

PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "Sysprep.inf" }
PS C:\> Set-SCScript -Script $Script -Description "Windows Server 2008 R2 Sysprep Answer File"

El primer comando recupera el objeto de script de archivo de respuesta denominado Sysprep.inf de la biblioteca en VMMServer01 y, a continuación, almacena el objeto en la variable $Script.

El segundo comando cambia la descripción de este objeto de script a "Windows Server 2008 R2 Sysprep Answer File".

Ejemplo 2: Deshabilitar un script de Windows PowerShell almacenado en la biblioteca VMM

PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1" }
PS C:\> Set-SCScript -Script $Script -Enabled $FALSE

El primer comando obtiene el objeto de script de PowerShell denominado AddHost.ps1 y almacena el objeto en la variable $Script.

El segundo comando deshabilita el script almacenado en $Script.

Ejemplo 3: Especificar un propietario para todos los scripts con un propietario desconocido

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"

Este comando obtiene todos los objetos de script de la biblioteca VMM cuyo propietario es Desconocido y, a continuación, especifica un propietario para cada objeto de script.

Parámetros

-Description

Especifica una descripción para el script.

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

-Enabled

Habilita un objeto cuando se establece en $True o deshabilita un objeto cuando se establece en $False. Por ejemplo, si desea actualizar software en una plantilla de máquina virtual, puede deshabilitar el objeto de plantilla de la biblioteca VMM para impedir temporalmente que los usuarios usen ese objeto.

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

-FamilyName

Especifica un nombre de familia para un recurso físico en la biblioteca VMM. Este valor se usa junto con Release, Namespace y Type para establecer la equivalencia entre los recursos de biblioteca.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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

-Name

Especifica el nombre de un objeto VMM.

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

-Owner

Especifica el propietario de un objeto VMM en forma de una cuenta de usuario de dominio válida.

  • Formato de ejemplo: -Owner "Contoso\PattiFuller"
  • Formato de ejemplo: -Owner "PattiFuller@Contoso"
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

-Release

Especifica una cadena que describe la versión de un recurso de biblioteca. VMM crea automáticamente un valor de versión para cada recurso importado en la biblioteca. Una vez importado el recurso, se puede personalizar la cadena.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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

-Scripts

Especifica una matriz de objetos de script.

Tipo:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SharePath

Especifica una ruta de acceso a un recurso compartido de biblioteca válido en un servidor de biblioteca existente que usa una ruta de acceso de convención de nomenclatura universal (UNC).

Formato de ejemplo: -SharePath \\LibServer01\LibShare.

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

-UserRole

Especifica un objeto de rol de usuario.

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

-VMMServer

Especifica un objeto de servidor VMM.

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

Salidas

Script

Este cmdlet devuelve un objeto Script.

Notas

  • Requiere un objeto de script VMM, que se puede recuperar mediante el cmdlet get-SCScript de .