Delen via

Set-SCScript

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een script dat is opgeslagen in de VMM-bibliotheek.

Syntaxis

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

De cmdlet Set-SCScript wijzigt een of meer eigenschappen van een script dat is opgeslagen in de VMM-bibliotheek (Virtual Machine Manager).

Eigenschappen die u kunt wijzigen, zijn onder andere:

  • Beschrijving
  • Ingeschakeld
  • Naam
  • Eigenaar
  • SharePath

Scriptobjecten vertegenwoordigen scriptbestanden die zijn opgeslagen in een bibliotheekshare op een bibliotheekserver. Deze scripts zijn doorgaans Windows PowerShell-scripts® of antwoordbestanden (zoals een Sysprep.inf- of een Unattend.xml-bestand) die de invoer bevatten die vereist is voor het Windows Setup-programma.

Voorbeelden

Voorbeeld 1: De beschrijving van een script wijzigen

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"

Met de eerste opdracht wordt het scriptobject voor het antwoordbestand met de naam Sysprep.inf opgehaald uit de bibliotheek op VMMServer01 en wordt het object vervolgens opgeslagen in de $Script variabele.

Met de tweede opdracht wordt de beschrijving van dit scriptobject gewijzigd in 'Windows Server 2008 R2 Sysprep Answer File'.

Voorbeeld 2: Een Windows PowerShell-script uitschakelen dat is opgeslagen in de VMM-bibliotheek

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

Met de eerste opdracht wordt het PowerShell-scriptobject met de naam AddHost.ps1 opgehaald en wordt het object opgeslagen in de variabele $Script.

Met de tweede opdracht wordt het script uitgeschakeld dat is opgeslagen in $Script.

Voorbeeld 3: Een eigenaar opgeven voor alle scripts met een onbekende eigenaar

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

Met deze opdracht worden alle scriptobjecten opgehaald uit de VMM-bibliotheek waarvan de eigenaar onbekend is en geeft u vervolgens een eigenaar op voor elk scriptobject.

Parameters

-Description

Hiermee geeft u een beschrijving voor het script.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Enabled

Hiermee schakelt u een object in wanneer dit is ingesteld op $True of schakelt u een object uit wanneer dit is ingesteld op $False. Als u bijvoorbeeld software wilt upgraden op een sjabloon voor virtuele machines, kunt u het sjabloonobject in de VMM-bibliotheek uitschakelen om tijdelijk te voorkomen dat gebruikers dat object gebruiken.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FamilyName

Hiermee geeft u een familienaam op voor een fysieke resource in de VMM-bibliotheek. Deze waarde wordt gebruikt in combinatie met Release, Naamruimte en Type om gelijkwaardigheid tussen bibliotheekbronnen tot stand te brengen.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Owner

Hiermee geeft u de eigenaar van een VMM-object in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Release

Hiermee geeft u een tekenreeks op die de release van een bibliotheekresource beschrijft. VMM maakt automatisch een releasewaarde voor elke resource die in de bibliotheek is geïmporteerd. Nadat de resource is geïmporteerd, kan de tekenreeks worden aangepast.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Script

Hiermee geeft u een VMM-scriptobject op.

Type:Script
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Scripts

Hiermee geeft u een matrix van scriptobjecten.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SharePath

Hiermee geeft u een pad naar een geldige bibliotheekshare op een bestaande bibliotheekserver die gebruikmaakt van een UNC-pad (Universal Naming Convention).

Voorbeeldindeling: -SharePath \\LibServer01\LibShare.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserRole

Hiermee geeft u een gebruikersrolobject.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Script

Met deze cmdlet wordt een Script-object geretourneerd.

Notities

  • Hiervoor is een VMM-scriptobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCScript.