Partager via

Get-SCScript

  • Référence
Module:
VirtualMachineManager

Obtient des objets de script à partir de la bibliothèque VMM, qui vous permet d’afficher ou de modifier n’importe quel script, ou d’afficher, modifier ou exécuter un script Windows PowerShell si vous disposez des autorisations appropriées.

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>]

Description

L’applet de commande Get-SCScript obtient des objets de script à partir de la bibliothèque Virtual Machine Manager (VMM). Le fichier script représenté par un objet script est stocké dans un système de fichiers sur un serveur de bibliothèque. En règle générale, ces scripts sont des scripts Windows PowerShell ® ou des scripts de fichiers de réponses (y compris les fichiers Sysprep.inf et Unattend.xml, qui contiennent les entrées requises pour le programme d’installation de Windows).

Comme illustré dans les exemples, vous pouvez utiliser Get-SCScript non seulement pour récupérer des objets de script, mais également, si vous disposez des autorisations appropriées, pour afficher le contenu d’un script ou pour modifier un script. En outre, vous pouvez exécuter le script si les conditions suivantes sont remplies : 1) le script est un script Windows PowerShell, 2) le script est activé sur votre serveur et 3) vous disposez des autorisations appropriées (voir l’exemple 5).

Pour plus d’informations sur l’activation des scripts Windows PowerShell sur votre serveur, tapez Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailedet Get-Help Set-ExecutionPolicy -Detailed.

Exemples

Exemple 1 : Obtenir tous les scripts stockés sur tous les serveurs de bibliothèque VMM

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

Cette commande obtient tous les objets de script stockés dans les partages de bibliothèque dans la bibliothèque VMM sur VMMServer01, puis affiche des informations sur ces scripts à l’utilisateur.

Exemple 2 : Afficher les informations spécifiées sur tous les scripts sur un serveur de bibliothèque

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" } | Format-List -Property Name, LibraryServer, SharePath

Cette commande obtient tous les objets de script stockés sur LibraryServer01 et affiche le nom, le serveur de bibliothèque et le chemin d’accès de ces scripts à l’utilisateur.

Exemple 3 : Obtenir tous les scripts portant un nom spécifique sur n’importe quel serveur de bibliothèque VMM

PS C:\> Get-SCScript -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Sysprep.inf" }

Cette commande obtient les objets de script de fichier de réponses nommés Sysprep.inf qui sont stockés sur n’importe quel serveur de bibliothèque sur VMMServer01.

Remarque : Par défaut, le nom d’un objet de script dans la bibliothèque VMM est le même nom, y compris l’extension de fichier, que le nom du fichier de script réel sur le serveur de bibliothèque.

Exemple 4 : Afficher un script stocké dans la bibliothèque VMM

PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1"}
PS C:\> Notepad.exe $Script.SharePath

La première commande obtient l’objet de script nommé SummarizeVMMInfo.ps1 à partir de la bibliothèque VMM et stocke l’objet dans la variable $Script.

La deuxième commande utilise le Bloc-notes pour ouvrir le script afin que vous puissiez afficher son contenu si vous disposez des autorisations appropriées pour lire le script.

Remarque : Si vous disposez des autorisations d’écriture appropriées, vous pouvez également modifier le script et enregistrer la nouvelle version.

Exemple 5 : Exécuter un script Windows PowerShell stocké dans la bibliothèque VMM

PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1" }
PS C:\> &$Script.SharePath

La première commande obtient l’objet de script nommé « SummarizeVMMInfo.ps1 » de la bibliothèque VMM et stocke l’objet dans la variable $Script.

La deuxième commande utilise l’opérateur esperluette (&) pour exécuter le script stocké dans $Script.

Pour exécuter un script Windows PowerShell stocké dans un partage de bibliothèque VMM, vous devez vérifier les éléments suivants :

  • Vous disposez d’autorisations de lecture et d’exécution sur le fichier de script.

  • Vous êtes membre du rôle d’utilisateur Administrateurs VMM.

  • Vous disposez des autorisations nécessaires pour accéder au partage de bibliothèque VMM.

  • Windows PowerShell script est activé. Si ce n’est pas le cas :

Exécutez l’interpréteur de commandes VMM en tant qu’administrateur. 2. Utilisez l’applet de commande Set-ExecutionPolicy pour définir la stratégie d’exécution au niveau approprié pour votre environnement.

Pour plus d’informations, tapez Get-Help about_Signing, Get-Help Get-ExecutionPolicy -Detailedet Get-Help Set-ExecutionPolicy -Detailed

Paramètres

-All

Indique que cette applet de commande obtient tous les objets subordonnés indépendamment de l’objet parent. Par exemple, la commande Get-SCVirtualDiskDrive -All obtient tous les objets de lecteur de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-FamilyName

Spécifie un nom de famille pour une ressource physique dans la bibliothèque VMM. Cette valeur est utilisée conjointement avec Release, Namespace et Type pour établir l’équivalence entre les ressources de la bibliothèque.

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

-ID

Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.

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

-Name

Spécifie le nom d’un objet VMM.

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

-Release

Spécifie une chaîne qui décrit la mise en production d’une ressource de bibliothèque. VMM crée automatiquement une valeur de mise en production pour chaque ressource importée dans la bibliothèque. Une fois la ressource importée, la chaîne peut être personnalisée.

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

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

Script

Cette applet de commande retourne un objet Script .