Share via

Set-SCScript

  • Riferimento
Modulo:
VirtualMachineManager

Modifica le proprietà di uno script archiviato nella libreria VMM.

Sintassi

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

Descrizione

Il cmdlet Set-SCScript modifica una o più proprietà di uno script archiviato nella libreria VMM (Virtual Machine Manager).

Le proprietà modificabili sono le seguenti:

  • Descrizione
  • Attivato
  • Nome
  • Proprietario
  • SharePath

Gli oggetti script rappresentano file di script archiviati in una condivisione di libreria su un server di libreria. In genere, questi script sono Windows PowerShell ® script o file di risposta (ad esempio un file Sysprep.inf o un file di Unattend.xml) che contengono gli input necessari per il programma di installazione di Windows.

Esempio

Esempio 1: Modificare la descrizione di uno 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"

Il primo comando recupera l'oggetto script del file di risposta denominato Sysprep.inf dalla libreria in VMMServer01 e quindi archivia l'oggetto nella variabile $Script.

Il secondo comando modifica la descrizione di questo oggetto script in "Windows Server 2008 R2 Sysprep Answer File".

Esempio 2: Disabilitare uno script di Windows PowerShell archiviato nella libreria 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

Il primo comando ottiene l'oggetto script di PowerShell denominato AddHost.ps1 e archivia l'oggetto nella variabile $Script.

Il secondo comando disabilita lo script archiviato in $Script.

Esempio 3: Specificare un proprietario per tutti gli script con un proprietario sconosciuto

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

Questo comando ottiene tutti gli oggetti script dalla libreria VMM il cui proprietario è Sconosciuto e quindi specifica un proprietario per ogni oggetto script.

Parametri

-Description

Specifica una descrizione per lo script.

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

-Enabled

Abilita un oggetto quando impostato su $True o disabilita un oggetto quando impostato su $False. Se ad esempio si desidera aggiornare il software in un modello di macchina virtuale, sarà possibile disabilitare l'oggetto modello nella libreria VMM per impedire temporaneamente agli utenti di utilizzare tale oggetto.

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

-FamilyName

Specifica un nome di famiglia per una risorsa fisica nella libreria VMM. Questo valore viene usato insieme a Release, Namespace e Type per stabilire l'equivalenza tra le risorse della libreria.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-Name

Specifica il nome di un oggetto di VMM.

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

-Owner

Specifica il proprietario di un oggetto VMM sotto forma di account utente di dominio valido.

  • Formato di esempio: -Owner "Contoso\PattiFuller"
  • Formato di esempio: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

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

-Release

Specifica una stringa che descrive la versione di una risorsa di libreria. VMM crea automaticamente un valore di versione per ogni risorsa importata nella libreria. Dopo l'importazione della risorsa, la stringa può essere personalizzata.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

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

-Script

Specifica un oggetto script di VMM.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scripts

Specifica una matrice di oggetti 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

Specifica il percorso di una condivisione di libreria valida su un server di libreria esistente che utilizza un percorso UNC (Universal Naming Convention).

Formato di esempio: -SharePath \\LibServer01\LibShare.

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

-UserRole

Specifica un oggetto ruolo utente.

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

Output

Script

Questo cmdlet restituisce un oggetto Script .

Note

  • Richiede un oggetto script VMM, che può essere recuperato usando il cmdlet Get-SCScript .