Partager via

Get-SCScript

  • Référence
Module:
VirtualMachineManager

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

Syntaxe

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 de script qu’un objet de script représente est stocké dans le 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 fichier de réponse (y compris Sysprep.inf et des fichiers 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 d’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 éléments suivants sont vrais : 1) le script est un script Windows PowerShell, 2) le script est activé sur votre serveur et 3) vous disposez d’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 de partage de ces scripts à l’utilisateur.

Exemple 3 : Obtenir tous les scripts avec 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 réponse nommés Sysprep.inf 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 de pouvoir afficher son contenu si vous disposez des autorisations appropriées pour lire le script.

Remarque : Si vous disposez d’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» à partir de la bibliothèque VMM et stocke l’objet dans la variable $Script.

La deuxième commande utilise l’opérateur ampersand (&) 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 ce qui suit :

  • 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.

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

Exécutez l’interpréteur de commandes VMM en tant qu’administrateur. 2. Utilisez la cmdlet Set-ExecutionPolicy pour définir la stratégie d’exécution sur le 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 de modèle auquel chaque objet de lecteur de disque virtuel est associé.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 bibliothèque.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

Script

Cette applet de commande retourne un objet Script.