Partager via

Set-SCScriptCommandSetting

  • Référence
Module:
VirtualMachineManager

Configure un paramètre de commande de script.

Syntaxe

Set-SCScriptCommandSetting
   [-ScriptCommandSetting] <SCScriptCommandSetting>
   [-AlwaysReboot <Boolean>]
   [-FailOnMatch]
   [-WarnAndContinueOnMatch]
   [-MatchExitCode <String>]
   [-MatchStandardError <String>]
   [-MatchStandardOutput <String>]
   [-PersistStandardErrorPath <String>]
   [-PersistStandardOutputPath <String>]
   [-MatchRebootExitCode <String>]
   [-RestartScriptOnExitCodeReboot <Boolean>]
   [-WorkingDirectory <String>]
   [-CommandMayReboot]
   [-RestartOnRetry <Boolean>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCScriptCommandSetting configure un paramètre de commande de script.

Exemples

Exemple 1 : Mettre à jour le répertoire de travail associé à la commande de script

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PreInstall"}
PS C:\> $ScriptCmdSetting = Get-SCScriptCommandSetting -ScriptCommand $ScriptCommand
PS C:\> Set-SCScriptCommandSetting -ScriptCommandSetting $ScriptCmdSetting -WorkingDirectory "Working_Folder_03"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptCmdSetting

La première commande obtient l’objet de profil d’application nommé SvcWebAppProfile01 et stocke l’objet dans la variable $AppProfile.

La deuxième commande obtient la commande de script nommée PreInstall pour le profil d’application stocké dans $AppProfile, puis stocke l’objet dans la variable $ScriptCommand.

La troisième commande obtient l’objet de paramètre de commande de script pour la commande de script stockée dans $ScriptCommand et stocke l’objet dans la variable $ScriptCmdSetting.

La quatrième commande définit le paramètre de répertoire de travail sur Working_Folder_03.

La dernière commande met à jour la commande de script stockée dans $ScriptCommand avec les paramètres stockés dans $ScriptCmdSetting.

Paramètres

-AlwaysReboot

Indique si un ordinateur ou une machine virtuelle doit toujours redémarrer une fois le script en cours d’exécution.

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

-CommandMayReboot

Indique que la commande de script peut redémarrer l’ordinateur ou la machine virtuelle.

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

-FailOnMatch

Indique que l’action effectuée lorsqu’une stratégie d’échec est mise en correspondance est d’échouer.

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

-MatchExitCode

Spécifie le code de sortie de la stratégie d’échec.

Exemple de format : -MatchExitCode "[1-9][0-9]*"

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

-MatchRebootExitCode

Spécifie le code de sortie de la stratégie de redémarrage.

Exemple de format : -MatchRebootExitCode "{1641}|{3010}|{3011}"

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

-MatchStandardError

Spécifie l’erreur standard de stratégie d’échec.

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

-MatchStandardOutput

Spécifie la sortie standard de la stratégie d’échec.

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

-PersistStandardErrorPath

Spécifie le chemin d’accès au fichier pour stocker l’erreur standard.

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

-PersistStandardOutputPath

Spécifie le chemin d’accès au fichier pour stocker la sortie standard.

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

-RestartOnRetry

Indique si un script est redémarré lors du redémarrage du travail VMM si l’échec du travail précédent était dû à un échec de script lorsqu’il est utilisé conjointement avec New-SCScriptCommandSetting ou Set-SCScriptCommandSetting.

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

-RestartScriptOnExitCodeReboot

Indique si le script redémarre après le redémarrage de l’ordinateur ou de la machine virtuelle lorsqu’un code de sortie est mis en correspondance.

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

-ScriptCommandSetting

Spécifie un objet de paramètre de commande de script.

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

-WarnAndContinueOnMatch

Indique que l’action effectuée lorsqu’une stratégie d’échec est mise en correspondance est d’avertir l’utilisateur et de poursuivre l’opération.

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

-WorkingDirectory

Spécifie un répertoire de travail pour une commande de script.

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

Sorties

ScriptCommandSetting

Cette applet de commande retourne un objet ScriptCommandSetting.