Freigeben über

New-CMTSStepConditionSoftware

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine installierte Softwarebedingung für einen Tasksequenzschritt.

Syntax

New-CMTSStepConditionSoftware
   [-IsAnyVersion <Boolean>]
   -MsiFilePath <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein installiertes Softwarebedingungsobjekt für einen Tasksequenzschritt zu erstellen. Verwenden Sie dann eines der Cmdlets New-CMTSStep* oder Set-CMTSStep* mit den Parametern Condition oder AddCondition . Beispiel: Set-CMTSStepApplyDataImage.

Weitere Informationen finden Sie unter Verwenden des Tasksequenz-Editors: Bedingungen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1

In diesem Beispiel wird zunächst ein Bedingungsobjekt für die MSI der Configuration Manager-Konsole erstellt.

Anschließend wird das Cmdlet Set-CMTSStepRunPowerShellScript verwendet, um dieses Bedingungsobjekt dem Schritt PowerShell-Skript ausführen der Tasksequenz Standardbetriebssystembereitstellung hinzuzufügen.

$msi = "\\cm01.contoso.com\SMS_XYZ\bin\i386\adminconsole.msi"

$condition = New-CMTSStepConditionSoftware -MsiFilePath $msi -IsAnyVersion $true

$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"

Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition

Dieses Beispielskript erstellt die folgende Bedingung für den Schritt:

Software An version of "Microsoft Endpoint Configuration Manager Console" installed

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IsAnyVersion

Verwenden Sie diesen Parameter, um zu bestimmen, wie die Bedingung mit den MSI-Codes übereinstimmt:

  • $true: Übereinstimmung mit jeder Version dieses Produkts, nur MSI-Upgradecode
  • $false: Übereinstimmung mit diesem spezifischen Produkt, MSI-Produktcode und Upgradecode

Wenn Sie diesen Parameter nicht angeben, stimmt er standardmäßig mit dem jeweiligen Produkt überein.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MsiFilePath

Geben Sie den Pfad zur msi-Datei an, die ausgewertet werden soll. Das Cmdlet liest die Produktdetails aus dieser MSI. Der Pfad zur MSI wird nicht gespeichert, nur die Produktdetails.

Beispielsweise werden die folgenden Details für die Configuration Manager-Version 2107 AdminConsole.msigespeichert:

  • ProductCode: {B3842C82-95EB-472C-940A-D82C4A10857D}
  • ProductName: Microsoft Endpoint Configuration Manager-Konsole
  • UpgradeCode: {B038D5E8-6C93-4A05-9E21-240324CFDF0E}
  • Version: 5.2107.1059.1000
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_SoftwareConditionExpression-Server-WMI-Klasse.