Delen via

Set-SCScript

  • Referentie
Module:
VirtualMachineManager

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

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

De set-SCScript-cmdlet 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 meestal 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 van 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 $Script variabele.

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

Hiermee schakelt u een object in wanneer deze is ingesteld op $True of schakelt u een object uit wanneer dit is ingesteld op $False. Als u bijvoorbeeld software wilt upgraden op een virtuele-machinesjabloon, 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van een VMM-object.

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

-Owner

Geeft de eigenaar van een VMM-object aan in de vorm van een geldig domeingebruikersaccount.

  • Voorbeeldindeling: -Owner "Contoso\PattiFuller"
  • Voorbeeldindeling: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Hiermee geeft u een VMM-scriptobject op.

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

-Scripts

Hiermee geeft u een matrix van scriptobjecten.

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

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Hiermee geeft u een gebruikersrolobject.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

Script

Met deze cmdlet wordt een scriptobject geretourneerd.

Notities

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