Partager via

Set-SCScript

Module:
VirtualMachineManager Module

Modifie les propriétés d’un script stocké dans la bibliothèque VMM.

Syntaxe

Default 

Set-SCScript
    [-Script] <Script>
    [-UserRole <UserRole>]
    [-Enabled <Boolean>]
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-SharePath <String>]
    [-Description <String>]
    [-Owner <String>]
    [-FamilyName <String>]
    [-Release <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

EquivalencySet 

Set-SCScript
    [-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
    -FamilyName <String>
    -Release <String>
    [-VMMServer <ServerConnection>]
    [-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 les suivantes :

  • Descriptif
  • Activé
  • Nom
  • Propriétaire
  • Chemin d’accès partagé

Les objets de script représentent des 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 des scripts Windows PowerShell® 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 du 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 remplace la description de cet objet de script par « Fichier de réponses Windows Server 2008 R2 Sysprep ».

Exemple 2 : Désactiver un script 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 récupère 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 dont le propriétaire est inconnu

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"

Cette commande récupère 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.

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

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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, si vous souhaitez mettre à niveau un logiciel sur un modèle de machine virtuelle, vous pouvez désactiver l’objet modèle dans la bibliothèque VMM pour empêcher temporairement les utilisateurs d’utiliser cet objet.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
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

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

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

(All)
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

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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"

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

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

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

(All)
Position:Named
Obligatoire:False
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

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-Script

Spécifie un objet de script VMM.

Propriétés du paramètre

Type:Script
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Default
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Scripts

Spécifie un tableau d’objets de script.

Propriétés du paramètre

Type:

System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

EquivalencySet
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 UNC (Universal Naming Convention).

Exemple de format : -SharePath \\LibServer01\LibShare.

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

Default
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UserRole

Spécifie un objet de rôle d’utilisateur.

Propriétés du paramètre

Type:UserRole
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

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

Notes

  • Nécessite un objet de script VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCScript .