Get-SCScript
Ruft Skriptobjekte aus der VMM-Bibliothek ab, mit der Sie Skripts anzeigen oder bearbeiten oder ein Windows PowerShell-Skript anzeigen, bearbeiten oder ausführen können, wenn Sie über die entsprechenden Berechtigungen verfügen.
Syntax
All (Standardwert)
Get-SCScript
[-VMMServer <ServerConnection>]
[-All]
[<CommonParameters>]
NameParamSet
Get-SCScript
-Name <String>
[-VMMServer <ServerConnection>]
[<CommonParameters>]
EquivalentResourceParamSet
Get-SCScript
-FamilyName <String>
[-VMMServer <ServerConnection>]
[-Release <String>]
[<CommonParameters>]
ID
Get-SCScript
[-VMMServer <ServerConnection>]
[-ID <Guid>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-SCScript ruft Skriptobjekte aus der VMM-Bibliothek (Virtual Machine Manager) ab. Die Skriptdatei, die ein Skriptobjekt darstellt, wird im Dateisystem auf einem Bibliothekserver gespeichert. In der Regel handelt es sich bei diesen Skripts entweder um Windows PowerShell-Skripts® oder Antwortdateiskripts (einschließlich Sysprep.inf und Unattend.xml Dateien, die die für das Windows Setup-Programm erforderlichen Eingaben enthalten).
Wie in den Beispielen veranschaulicht, können Sie Get-SCScript nicht nur zum Abrufen von Skriptobjekten verwenden, sondern auch, wenn Sie über die entsprechenden Berechtigungen verfügen, zum Anzeigen des Inhalts eines Skripts oder zum Bearbeiten eines Skripts. Darüber hinaus können Sie das Skript ausführen, wenn Folgendes zutrifft: 1) Es handelt sich bei dem Skript um ein Windows PowerShell-Skript, 2) die Skripterstellung ist auf Ihrem Server aktiviert, und 3) Sie verfügen über die entsprechenden Berechtigungen (siehe Beispiel 5).
Informationen zum Aktivieren von Windows PowerShell-Skripts auf dem Server erhalten Sie, indem Sie Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailedund Get-Help Set-ExecutionPolicy -Detailedeingeben.
Beispiele
Beispiel 1: Abrufen aller Skripts, die auf allen VMM-Bibliothekservern gespeichert sind
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com"
Mit diesem Befehl werden alle Skriptobjekte abgerufen, die in Bibliotheksfreigaben in der VMM-Bibliothek auf VMMServer01 gespeichert sind, und dem Benutzer werden dann Informationen zu diesen Skripts angezeigt.
Beispiel 2: Anzeigen bestimmter Informationen zu allen Skripts auf einem Bibliothekserver
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" } | Format-List -Property Name, LibraryServer, SharePath
Mit diesem Befehl werden alle auf LibraryServer01 gespeicherten Skriptobjekte abgerufen, und der Benutzer wird der Name, der Bibliothekserver und der Freigabepfad für diese Skripts angezeigt.
Beispiel 3: Abrufen aller Skripts mit einem bestimmten Namen auf einem beliebigen VMM-Bibliothekserver
PS C:\> Get-SCScript -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Sysprep.inf" }
Mit diesem Befehl werden die Skriptobjekte der Antwortdatei mit dem Namen "Sysprep.inf" abgerufen, die auf einem beliebigen Bibliothekserver in VMMServer01 gespeichert sind.
Hinweis: Standardmäßig entspricht der Name eines Skriptobjekts in der VMM-Bibliothek, einschließlich der Dateierweiterung, dem Namen der eigentlichen Skriptdatei auf dem Bibliothekserver.
Beispiel 4: Anzeigen eines Skripts, das in der VMM-Bibliothek gespeichert ist
PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1"}
PS C:\> Notepad.exe $Script.SharePath
Mit dem ersten Befehl wird das Skriptobjekt mit dem Namen SummarizeVMMInfo.ps1 aus der VMM-Bibliothek abgerufen und in der Variablen $Script gespeichert.
Der zweite Befehl verwendet Editor, um das Skript zu öffnen, sodass Sie seinen Inhalt anzeigen können, wenn Sie über die entsprechenden Berechtigungen zum Lesen des Skripts verfügen.
Hinweis: Wenn Sie über die entsprechenden Schreibberechtigungen verfügen, können Sie das Skript auch bearbeiten und die neue Version speichern.
Beispiel 5: Ausführen eines Windows PowerShell-Skripts, das in der VMM-Bibliothek gespeichert ist
PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1" }
PS C:\> &$Script.SharePath
Mit dem ersten Befehl wird das Skriptobjekt mit dem Namen "SummarizeVMMInfo.ps1" aus der VMM-Bibliothek abgerufen und in der Variablen $Script gespeichert.
Der zweite Befehl verwendet den kaufmännischen Und-Operator (&), um das in $Script gespeicherte Skript auszuführen.
Zum Ausführen eines Windows PowerShell-Skripts, das in einer VMM-Bibliotheksfreigabe gespeichert ist, müssen Sie Folgendes sicherstellen:
Sie verfügen über Lese- und Ausführungsberechtigungen für die Skriptdatei.
Sie sind Mitglied der Benutzerrolle VMM-Administratoren.
Sie verfügen über Berechtigungen für den Zugriff auf die VMM-Bibliotheksfreigabe.
Windows PowerShell-Skripterstellung ist aktiviert. Wenn dem nicht so ist:
Führen Sie die VMM-Befehlsshell als Administrator aus. 2. Verwenden Sie das Cmdlet Set-ExecutionPolicy , um die Ausführungsrichtlinie auf die entsprechende Ebene für Ihre Umgebung festzulegen.
Weitere Informationen erhalten Sie, wenn Sie Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailedund Get-Help Set-ExecutionPolicy -Detailed
Parameter
-All
Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft.
Der Befehl Get-SCVirtualDiskDrive -All ruft z. B. alle Objekte des virtuellen Laufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes Objekt des virtuellen Laufwerks zugeordnet ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
All
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
EquivalentResourceParamSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ID
Gibt den numerischen Bezeichner als GUID (Globally Unique Identifier) für ein bestimmtes Objekt an.
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ID
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
NameParamSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Release
Gibt eine Zeichenfolge an, die die Freigabe einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Releasewert für jede Ressource, die in die Bibliothek importiert wird. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
EquivalentResourceParamSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
Parametereigenschaften
| Typ: | ServerConnection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben
Script
Dieses Cmdlet gibt ein Script-Objekt zurück.