Set-SCScriptCommandSetting
Configure un paramètre de commande de script.
Syntax
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 $ScriptCmdSettingLa 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 que le script a terminé son exécution.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandMayReboot
Indique que la commande de script peut redémarrer l’ordinateur ou la machine virtuelle.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FailOnMatch
Indique que l’action effectuée lorsqu’une stratégie d’échec est en correspondance est d’échouer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MatchStandardError
Spécifie l’erreur standard de la stratégie d’échec.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MatchStandardOutput
Spécifie la sortie standard de la stratégie d’échec.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistStandardErrorPath
Spécifie le chemin d’accès au fichier pour stocker l’erreur standard.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistStandardOutputPath
Spécifie le chemin d’accès du fichier pour stocker la sortie standard.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptCommandSetting
Spécifie un objet de paramètre de commande de script.
| Type: | SCScriptCommandSetting |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
Spécifie un répertoire de travail pour une commande de script.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Sorties
ScriptCommandSetting
Cette applet de commande retourne un objet ScriptCommandSetting .