New-CMTSStepConditionSoftware

  • Riferimento
Modulo:
ConfigurationManager

Creare una condizione software installata per un passaggio della sequenza di attività.

Sintassi

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

Descrizione

Usare questo cmdlet per creare un oggetto condizione software installato per un passaggio della sequenza di attività. Usare quindi uno dei cmdlet New-CMTSStep* o Set-CMTSStep* con i parametri Condition o AddCondition . Ad esempio, Set-CMTSStepApplyDataImage.

Per altre informazioni, vedere Usare l'editor della sequenza di attività: Condizioni.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio viene innanzitutto creato un oggetto condizione per l'identità del servizio gestito della console Configuration Manager.

Viene quindi usato il cmdlet Set-CMTSStepRunPowerShellScript per aggiungere questo oggetto condizione al passaggio Esegui script powershell della sequenza di attività di distribuzione del sistema operativo predefinito .

$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

Questo script di esempio crea la condizione seguente nel passaggio:

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

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-IsAnyVersion

Usare questo parametro per determinare come la condizione corrisponde ai codici MSI:

  • $true: corrisponde a qualsiasi versione di questo prodotto, solo codice di aggiornamento msi
  • $false: corrisponde a questo prodotto specifico, al codice del prodotto MSI e al codice di aggiornamento

Se non si specifica questo parametro, per impostazione predefinita corrisponde al prodotto specifico.

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

-MsiFilePath

Specificare il percorso del file MSI da valutare. Il cmdlet legge i dettagli del prodotto dall'identità del servizio gestito. Il percorso dell'identità del servizio gestito non viene salvato, ma solo i dettagli del prodotto.

Ad esempio, salva i dettagli seguenti per la versione Configuration Manager 2107 AdminConsole.msi:

  • ProductCode: {B3842C82-95EB-472C-940A-D82C4A10857D}
  • ProductName: Microsoft Endpoint Configuration Manager Console
  • UpgradeCode: {B038D5E8-6C93-4A05-9E21-240324CFDF0E}
  • Version: 5.2107.1059.1000
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_SoftwareConditionExpression classe WMI del server.