Compartir a través de

Set-SCScript

Módulo:
VirtualMachineManager Module

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

Sintaxis

Default 

Set-SCScript
    [-Script] <Script>
    [-UserRole <UserRole>]
    [-Enabled <Boolean>]
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-SharePath <String>]
    [-Description <String>]
    [-Owner <String>]
    [-FamilyName <String>]
    [-Release <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

EquivalencySet 

Set-SCScript
    [-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
    -FamilyName <String>
    -Release <String>
    [-VMMServer <ServerConnection>]
    [-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
  • Activado
  • Nombre
  • Propietario
  • SharePath (Ruta de acceso compartido)

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 un archivo 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 del archivo de respuesta denominado Sysprep.inf de la biblioteca de 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 Unknown y, a continuación, especifica un propietario para cada objeto de script.

Parámetros

-Description

Especifica una descripción para el script.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Enabled

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

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que este progreso se almacena en la variable denominada por este parámetro.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre de un objeto VMM.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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"

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Release

Especifica una cadena que describe la liberació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, la cadena se puede personalizar.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Script

Especifica un objeto de script VMM.

Propiedades del parámetro

Tipo:Script
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Scripts

Especifica una matriz de objetos de script.

Propiedades del parámetro

Tipo:

System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

EquivalencySet
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserRole

Especifica un objeto de rol de usuario.

Propiedades del parámetro

Tipo:UserRole
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Default
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VMMServer

Especifica un objeto de servidor VMM.

Propiedades del parámetro

Tipo:ServerConnection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

Script

Este cmdlet devuelve un objeto Script .

Notas

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