New-CMTSStepInstallSoftware
Erstellen Sie einen Installationspaketschritt, den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepInstallSoftware
[-BaseVariableName <String>]
[-ContinueOnInstallError]
[-Program <IResultObject>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Mit diesem Cmdlet wird ein neues Schrittobjekt für das Installationspaket erstellt. Verwenden Sie dann das Cmdlet "Add-CMTaskSequenceStep", um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu den Schritten der Tasksequenz: Installieren des Pakets.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel1
In diesem Beispiel wird zunächst das Cmdlet "Get-CMProgram" verwendet, um das Installationsprogramm aus dem Paket mit der ID XYZ0000Fabzurufen.
In der nächsten Zeile wird mithilfe der Programmvariablen ein Objekt für den Schritt "Paket installieren" erstellt.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz bei Index 11 hinzu.
$program = Get-CMProgram -PackageId "XYZ0000F" -ProgramName "Install"
$step = New-CMTSStepInstallSoftware -Name "Install Package" -Program $program
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parameter
-BaseVariableName
Verwenden Sie diesen Parameter, um Softwarepakete gemäß einer Liste dynamischer Variablen zu installieren. Anschließend installiert die Tasksequenz Pakete mit diesem Basisvariablennamen. Weitere Informationen finden Sie unter Installieren von Softwarepaketen gemäß der Liste dynamischer Variablen.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Bedingung
Geben Sie ein Bedingungsobjekt an, das für diesen Schritt verwendet werden soll. Um dieses Objekt abzurufen, verwenden Sie eines der Cmdlets für die Tasksequenzbedingung. Beispiel: Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption "Continue on error" zu aktivieren. Wenn Sie diese Option aktivieren, wird die Tasksequenz fortgesetzt, wenn der Schritt fehlschlägt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnInstallError
Fügen Sie diesen Parameter hinzu, um die Installation anderer Pakete in der Liste fortzusetzen, wenn ein Paket nicht installiert werden kann. Wenn Sie diese Einstellung nicht angeben und die Installation fehlschlägt, wird der Schritt sofort beendet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Program
Geben Sie ein Programmobjekt aus einem zu installierenden Paket an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMProgram".
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Keine
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_InstallSoftwareAction Server-WMI-Klasse.