Set-SCScript
Modifie les propriétés d’un script stocké dans la bibliothèque VMM.
Syntax
Set-SCScript
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-Script] <Script>
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]Set-SCScript
[-VMMServer <ServerConnection>]
[-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]Description
L’applet de commande Set-SCScript modifie une ou plusieurs propriétés d’un script stocké dans la bibliothèque Virtual Machine Manager (VMM).
Les propriétés que vous pouvez modifier sont notamment :
- Description
- activé
- Nom
- Propriétaire
- SharePath
Les objets scripts représentent les fichiers de script stockés dans un partage de bibliothèque sur un serveur de bibliothèque. En règle générale, ces scripts sont soit Windows PowerShell ® des scripts ou des fichiers de réponses (tels qu’un fichier Sysprep.inf ou un fichier Unattend.xml) qui contiennent les entrées requises pour le programme d’installation de Windows.
Exemples
Exemple 1 : Modifier la description d’un script
PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "Sysprep.inf" }
PS C:\> Set-SCScript -Script $Script -Description "Windows Server 2008 R2 Sysprep Answer File"La première commande récupère l’objet de script de fichier de réponses nommé Sysprep.inf à partir de la bibliothèque sur VMMServer01, puis stocke l’objet dans la variable $Script.
La deuxième commande modifie la description de cet objet de script en « Fichier de réponses Sysprep Windows Server 2008 R2 ».
Exemple 2 : Désactiver un script de Windows PowerShell stocké dans la bibliothèque VMM
PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1" }
PS C:\> Set-SCScript -Script $Script -Enabled $FALSELa première commande obtient l’objet de script PowerShell nommé AddHost.ps1 et stocke l’objet dans la variable $Script.
La deuxième commande désactive le script stocké dans $Script.
Exemple 3 : Spécifier un propriétaire pour tous les scripts avec un propriétaire inconnu
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"Cette commande obtient tous les objets de script de la bibliothèque VMM dont le propriétaire est Inconnu, puis spécifie un propriétaire pour chaque objet de script.
Paramètres
-Description
Spécifie une description du script.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Enabled
Active un objet lorsqu’il est défini sur $True ou désactive un objet lorsqu’il est défini sur $False. Par exemple, pour effectuer la mise à niveau d’un logiciel sur un modèle d’ordinateur virtuel, vous pouvez désactiver l’objet modèle dans la bibliothèque Virtual Machine Manager pour empêcher temporairement les utilisateurs d’utiliser cet objet.
| Type: | Boolean |
| 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 bibliothèque.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.
- Exemple de format :
-Owner "Contoso\PattiFuller" - Exemple de format :
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Script
Spécifie un objet script VMM.
| Type: | Script |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scripts
Spécifie un tableau d’objets de script.
| Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SharePath
Spécifie un chemin d’accès à un partage de bibliothèque valide sur un serveur de bibliothèque existant qui utilise un chemin d’accès UNC (Universal Naming Convention).
Exemple de format : -SharePath \\LibServer01\LibShare.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
Spécifie un objet rôle d'utilisateur.
| Type: | UserRole |
| 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 .
Notes
- Nécessite un objet de script VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCScript .