Set-SCScript
Ändert die Eigenschaften eines skripts, das in der VMM-Bibliothek gespeichert ist.
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>]Beschreibung
Das Set-SCScript-Cmdlet ändert eine oder mehrere Eigenschaften eines Skripts, das in der VMM-Bibliothek (Virtual Machine Manager) gespeichert ist.
Sie können u. a. folgende Eigenschaften ändern:
- BESCHREIBUNG
- Aktiviert
- Name
- Besitzer
- SharePath
Skriptobjekte stellen Skriptdateien dar, die in einer Bibliotheksfreigabe auf einem Bibliothekserver gespeichert sind. In der Regel sind diese Skripts entweder Windows PowerShell ® Skripts oder Antwortdateien (z. B. eine Sysprep.inf- oder eine Unattend.xml-Datei), die die für das Windows Setup-Programm erforderlichen Eingaben enthalten.
Beispiele
Beispiel 1: Ändern der Beschreibung eines Skripts
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"Der erste Befehl ruft das Antwortdateiskriptobjekt mit dem Namen Sysprep.inf aus der Bibliothek auf VMMServer01 ab und speichert das Objekt dann in der $Script Variablen.
Der zweite Befehl ändert die Beschreibung dieses Skriptobjekts in "Windows Server 2008 R2 Sysprep Answer File".
Beispiel 2: Deaktivieren eines in der VMM-Bibliothek gespeicherten Windows PowerShell Skripts
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 $FALSEDer erste Befehl ruft das PowerShell-Skriptobjekt mit dem Namen AddHost.ps1 ab und speichert das Objekt in der $Script Variablen.
Der zweite Befehl deaktiviert das in $Script gespeicherte Skript.
Beispiel 3: Angeben eines Besitzers für alle Skripts mit einem unbekannten Besitzer
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"Dieser Befehl ruft alle Skriptobjekte aus der VMM-Bibliothek ab, deren Besitzer unbekannt ist, und gibt dann einen Besitzer für jedes Skriptobjekt an.
Parameter
-Description
Gibt eine Beschreibung für das Skript an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Enabled
Aktiviert ein Objekt, wenn er auf $True festgelegt ist, oder deaktiviert ein Objekt, wenn er auf $False festgelegt ist. Wenn Sie beispielsweise Software in einer Vorlage für virtuelle Maschinen aktualisieren möchten, können Sie das Vorlagenobjekt in der VMM-Bibliothek deaktivieren, um vorübergehend zu verhindern, dass Benutzer das Objekt verwenden.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FamilyName
Gibt einen Familiennamen für eine physische Ressource in der VMM-Bibliothek an. Dieser Wert wird in Verbindung mit Release, Namespace und Type verwendet, um die Äquivalenz zwischen Bibliotheksressourcen herzustellen.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an
- Beispielformat:
-Owner "Contoso\PattiFuller" - Beispielformat:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Release
Gibt eine Zeichenfolge an, die die Veröffentlichung einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Freigabewert für jede Ressource, die in die Bibliothek importiert wird. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Script
Gibt ein VMM-Skriptobjekt an.
| Type: | Script |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scripts
Gibt ein Array von Skriptobjekten an.
| 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
Gibt einen Pfad zu einer Bibliotheksfreigabe auf einem vorhandenen Bibliothekserver an, für den ein UNC-Pfad (Universal Naming Convention) verwendet wird.
Beispielformat: -SharePath \\LibServer01\LibShare.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
Gibt ein Benutzerrollenobjekt an.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Ausgaben
Script
Dieses Cmdlet gibt ein Script-Objekt zurück.
Hinweise
- Erfordert ein VMM-Skriptobjekt, das mithilfe des Cmdlets Get-SCScript abgerufen werden kann.