Delen via

New-SCScriptCommandSetting

  • Referentie
Module:
VirtualMachineManager

Hiermee maakt u een instellingenobject voor een scriptopdracht.

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

De cmdlet New-SCScriptCommandSetting maakt een instellingenobject voor een scriptopdracht.

Voorbeelden

Voorbeeld 1: Een werkmapinstelling toevoegen aan een scriptopdracht

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

Met de eerste opdracht wordt het toepassingsprofielobject met de naam SvcWebAppProfile01 opgehaald en wordt het object opgeslagen in de $AppProfile variabele.

Met de tweede opdracht wordt het scriptopdrachtobject PostInstall opgehaald voor het toepassingsprofiel dat is opgeslagen in $AppProfile.

Met de derde opdracht maakt u een nieuwe scriptopdrachtinstelling waarmee de werkmap wordt ingesteld op Working_Folder_02 en slaat u het object vervolgens op in de $ScriptSetting variabele.

Met de laatste opdracht wordt de werkmap bijgewerkt voor de scriptopdracht die is opgeslagen in $ScriptCommand om te worden Working_Folder_02 (de waarde van $ScriptSetting).

Parameters

-AlwaysReboot

Geeft aan of een computer of virtuele machine altijd opnieuw moet worden opgestart nadat het script is uitgevoerd.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommandMayReboot

Geeft aan dat de scriptopdracht de computer of virtuele machine opnieuw kan opstarten.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailOnMatch

Geeft aan dat de actie die wordt uitgevoerd wanneer een foutbeleid overeenkomt, mislukt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchExitCode

Hiermee geeft u de afsluitcode van het foutbeleid op.

Voorbeeldindeling: -MatchExitCode "[1-9][0-9]*"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchRebootExitCode

Hiermee geeft u het beleid voor opnieuw opstarten overeenkomen met afsluitcode.

Voorbeeldindeling: -MatchRebootExitCode "{1641}|{3010}|{3011}"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchStandardError

Hiermee geeft u de standaardfout van het foutbeleid op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchStandardOutput

Hiermee geeft u de standaarduitvoer van het foutbeleid op.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistStandardErrorPath

Hiermee geeft u het bestandspad op om de standaardfout op te slaan.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistStandardOutputPath

Hiermee geeft u het bestandspad op om de standaarduitvoer op te slaan.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartOnRetry

Geeft aan of een script opnieuw wordt opgestart bij het opnieuw opstarten van de VMM-taak als de vorige taak is mislukt vanwege een scriptfout bij gebruik in combinatie met New-SCScriptCommandSetting of Set-SCScriptCommandSetting.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartScriptOnExitCodeReboot

Geeft aan of het script opnieuw wordt opgestart nadat de computer of virtuele machine opnieuw is opgestart wanneer een afsluitcode overeenkomt.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WarnAndContinueOnMatch

Geeft aan dat de actie die wordt ondernomen wanneer een foutbeleid overeenkomt, de gebruiker waarschuwen en de bewerking voortzetten.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkingDirectory

Hiermee geeft u een werkmap voor een scriptopdracht.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Uitvoerwaarden

ScriptCommandSetting

Met deze cmdlet wordt een ScriptCommandSetting-object geretourneerd.