Get-SCScript
Obtient des objets de script à partir de la bibliothèque VMM, ce qui vous permet d’afficher ou de modifier n’importe quel script, ou d’afficher, de modifier ou d’exécuter un script Windows PowerShell si vous disposez des autorisations appropriées.
Syntaxe
All (Par défaut)
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>]
Description
L’applet de commande Get-SCScript récupère les objets de script à partir de la bibliothèque Virtual Machine Manager (VMM). Le fichier de script représenté par un objet de script est stocké dans le système de fichiers d’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 Sysprep.inf et les 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 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) il s’agit d’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 récupère 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 : Affichage d’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 récupère tous les objets de script stockés sur LibraryServer01 et affiche à l’utilisateur le nom, le serveur de bibliothèque et le chemin de partage de ces scripts.
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 récupère les objets de script du 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, y compris l’extension de fichier, que le nom du fichier de script réel sur le serveur de bibliothèque.
Exemple 4 : Affichage d’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 récupère 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 récupère 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 vous assurer que les éléments suivants sont les suivants :
Vous disposez des 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.
Les scripts Windows PowerShell sont activés. 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 récupère tous les objets subordonnés indépendamment de l’objet parent.
Par exemple, la commande Get-SCVirtualDiskDrive -All récupère tous les objets d’unité de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet modèle auquel chaque objet d’unité de disque virtuel est associé.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
All
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FamilyName
Spécifie le nom de famille d’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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
EquivalentResourceParamSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ID
Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ID
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom d’un objet VMM.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
NameParamSet
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Release
Spécifie une chaîne qui décrit la libération d’une ressource de bibliothèque. VMM crée automatiquement une valeur de version pour chaque ressource importée dans la bibliothèque. Une fois la ressource importée, la chaîne peut être personnalisée.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
EquivalentResourceParamSet
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-VMMServer
Spécifie un objet serveur VMM.
Propriétés du paramètre
| Type: | ServerConnection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Sorties
Script
Cette applet de commande retourne un objet Script .