Freigeben über

Get-SCScript

  • Referenz
Modul:
VirtualMachineManager

Ruft Skriptobjekte aus der VMM-Bibliothek ab, mit der Sie beliebige Skripts anzeigen oder bearbeiten oder ein Windows PowerShell Skript anzeigen, bearbeiten oder ausführen können, wenn Sie über entsprechende Berechtigungen verfügen.

Syntax

Get-SCScript
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]
Get-SCScript
   [-VMMServer <ServerConnection>]
   -Name <String>
   [<CommonParameters>]
Get-SCScript
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [<CommonParameters>]
Get-SCScript
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCScript ruft Skriptobjekte aus der VMM-Bibliothek (Virtual Machine Manager) ab. Die durch ein Skriptobjekt dargestellte Skriptdatei ist im Dateisystem eines Bibliothekservers gespeichert. In der Regel handelt es sich bei diesen Skripts entweder um Windows PowerShell ® Skripts oder um Antwortdateiskripts (einschließlich Sysprep.inf und Unattend.xml Dateien, die die für das Windows Setup-Programm erforderlichen Eingaben enthalten).

Wie in den Beispielen gezeigt, können Sie Get-SCScript nicht nur zum Abrufen von Skriptobjekten verwenden, sondern auch, wenn Sie über entsprechende Berechtigungen verfügen, zum Anzeigen der Inhalte eines Skripts oder zum Bearbeiten eines Skripts. Darüber hinaus können Sie das Skript ausführen, wenn Folgendes zutrifft: 1) das Skript ist ein Windows PowerShell Skript, 2) skripting ist auf Ihrem Server aktiviert, und 3) Sie verfügen über die entsprechenden Berechtigungen (siehe Beispiel 5).

Um Informationen zum Aktivieren Windows PowerShell Skripts auf Ihrem Server zu erhalten, geben Sie Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailedund Get-Help Set-ExecutionPolicy -Detailedein.

Beispiele

Beispiel 1: Abrufen aller Skripts, die auf allen VMM-Bibliotheksservern gespeichert sind

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com"

Dieser Befehl ruft alle Skriptobjekte ab, die in Bibliotheksfreigaben in der VMM-Bibliothek auf VMMServer01 gespeichert sind, und zeigt dem Benutzer dann Informationen zu diesen Skripts an.

Beispiel 2: Anzeigen von angegebenen 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

Dieser Befehl ruft alle Skriptobjekte ab, die auf LibraryServer01 gespeichert sind, und zeigt dem Benutzer den Namen, den Bibliotheksserver und den Freigabepfad für diese Skripts an.

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" }

Dieser Befehl ruft die Antwortdateiskriptobjekte mit dem Namen Sysprep.inf ab, die auf einem beliebigen Bibliothekserver auf VMMServer01 gespeichert sind.

Hinweis: Standardmäßig ist der Name eines Skriptobjekts in der VMM-Bibliothek derselbe Name, einschließlich der Dateierweiterung, wie der Name der eigentlichen Skriptdatei auf dem Bibliotheksserver.

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

Der erste Befehl ruft das Skriptobjekt mit dem Namen SummarizeVMMInfo.ps1 aus der VMM-Bibliothek ab und speichert das Objekt in der $Script Variablen.

Der zweite Befehl verwendet Editor, um das Skript zu öffnen, sodass Sie dessen Inhalt anzeigen können, wenn Sie über die entsprechenden Berechtigungen zum Lesen des Skripts verfügen.

Hinweis: Wenn Sie über entsprechende Schreibberechtigungen verfügen, können Sie auch das Skript 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

Der erste Befehl ruft das Skriptobjekt namens "SummarizeVMMInfo.ps1" aus der VMM-Bibliothek ab und speichert das Objekt in der variablen $Script.

Der zweite Befehl verwendet den operator ampersand (&), um das in $Script gespeicherte Skript auszuführen.

Um ein in einer VMM-Bibliotheksfreigabe gespeichertes Windows PowerShell Skript auszuführen, 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. Ist dies nicht der Fall:

Führen Sie die VMM-Befehlsshell als Administrator aus. 2. Verwenden Sie das Cmdlet Set-ExecutionPolicy , um die Ausführungsrichtlinie auf die für Ihre Umgebung geeignete Ebene festzulegen.

Weitere Informationen: 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. Beispielsweise ruft der Befehl Get-SCVirtualDiskDrive -All alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder vorlagenobjekts, dem jedes Objekt des virtuellen Datenträgerlaufwerks zugeordnet ist.

Type:SwitchParameter
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

-ID

Gibt den numerischen Bezeichner als global eindeutigen Bezeichner (GUID) für ein bestimmtes Objekt an.

Type:Guid
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:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
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.