Compartir a través de

Set-SCScript

  • Referencia
Módulo:
VirtualMachineManager

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

Syntax

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 se pueden cambiar se encuentran:

  • Descripción
  • habilitado
  • Nombre
  • Propietario
  • rutaDeAccesoDeRecursoCompartido

Los objetos de script representan archivos de script almacenados en un recurso compartido de biblioteca de un servidor de biblioteca. Normalmente, estos scripts son Windows PowerShell ® scripts o archivos de respuesta (como sysprep.inf o un archivo 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 "Archivo de respuesta sysprep de Windows Server 2008 R2".

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 en la biblioteca VMM para impedir temporalmente que los usuarios utilicen dicho objeto.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
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

-Name

Especifica el nombre de un objeto de VMM.

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

-Owner

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

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

-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.

Type:String
Position:Named
Default value:None
Required:True
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

-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

-Scripts

Especifica una matriz de objetos de script.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 la convención de nomenclatura universal (UNC).

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

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

-UserRole

Especifica un objeto de función de usuario.

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

-VMMServer

Especifica un objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 .