New-SCScriptCommandSetting
Crée un objet de paramètres pour une commande de script.
Syntax
New-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 New-SCScriptCommandSetting crée un objet de paramètres pour une commande de script.
Exemples
Exemple 1 : Ajouter un paramètre de répertoire de travail à une commande de script
PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PostInstall"}
PS C:\> $ScriptSetting = New-SCScriptCommandSetting -WorkingDirectory "Working_Folder_02"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptSettingLa 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 l’objet de commande de script nommé PostInstall pour le profil d’application stocké dans $AppProfile.
La troisième commande crée un paramètre de commande de script qui définit le répertoire de travail sur Working_Folder_02, puis stocke l’objet dans la variable $ScriptSetting.
La dernière commande met à jour le répertoire de travail de la commande de script stockée dans $ScriptCommand à Working_Folder_02 (la valeur de $ScriptSetting).
Paramètres
-AlwaysReboot
Indique si un ordinateur ou une machine virtuelle doit toujours redémarrer une fois le script terminé.
| 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 mises en correspondance est à é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 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 du 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 a été 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 une fois l’ordinateur ou la machine virtuelle redémarré 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 |
-WarnAndContinueOnMatch
Indique que l’action effectuée lorsqu’une stratégie d’échec est mise en correspondance consiste à avertir l’utilisateur et à 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 .