New-CMTSStepConditionSoftware
Crie uma condição de software instalada para uma etapa de sequência de tarefas.
Sintaxe
New-CMTSStepConditionSoftware
[-IsAnyVersion <Boolean>]
-MsiFilePath <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Use este cmdlet para criar um objeto de condição de software instalado para uma etapa de sequência de tarefas. Em seguida, use um dos cmdlets New-CMTSStep* ou Set-CMTSStep* com os parâmetros Condição ou AddCondition . Por exemplo, Set-CMTSStepApplyDataImage.
Para obter mais informações, consulte Usar o editor de sequência de tarefas: Condições.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1
Este exemplo cria primeiro um objeto de condição para o MSI do console Configuration Manager.
Em seguida, ele usa o cmdlet Set-CMTSStepRunPowerShellScript para adicionar esse objeto de condição à etapa Executar Script do PowerShell da sequência de tarefas de implantação do sistema operacional padrão .
$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
Este script de exemplo cria a seguinte condição na etapa:
Software An version of "Microsoft Endpoint Configuration Manager Console" installed
Parâmetros
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-IsAnyVersion
Use este parâmetro para determinar como a condição corresponde aos códigos MSI:
-
$true
: corresponder a qualquer versão deste produto, somente código de atualização MSI -
$false
: corresponder a este produto específico, código de produto MSI e código de atualização
Se você não especificar esse parâmetro, por padrão, ele corresponderá ao produto específico.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-MsiFilePath
Especifique o caminho para o arquivo MSI a ser avaliado. O cmdlet lê os detalhes do produto deste MSI. O caminho para o MSI não é salvo, apenas os detalhes do produto.
Por exemplo, ele salva os seguintes detalhes para o Configuration Manager versão 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
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_SoftwareConditionExpression classe WMI do servidor.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de