Partager via

Set-SCScript

  • Référence
Module:
VirtualMachineManager

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 $FALSE

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