Get-CMTSStepConditionSoftware

  • Referência
Módulo:
ConfigurationManager

Obtenha uma condição de software instalada a partir de um passo de sequência de tarefas.

Sintaxe

Get-CMTSStepConditionSoftware
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter um objeto de condição de software instalado a partir de um passo de sequência de tarefas. Pode utilizar este objeto para:

  • Veja os detalhes da condição no passo .
  • Copie a condição para outro passo de sequência de tarefas.

Quando utilizar os cmdlets New-CMTSStep* ou Set-CMTSStep* , forneça este objeto de condição com os parâmetros Condition ou AddCondition . Por exemplo, Set-CMTSStepApplyDataImage.

Para obter mais informações, veja Utilizar o editor de sequência de tarefas: Condições.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Ver os detalhes de uma condição de software

Este exemplo obtém primeiro a sequência de tarefas de implementação predefinida do SO e, em seguida, obtém o passo Definir Variáveis Dinâmicas . Transmite o objeto do passo da sequência de tarefas para este cmdlet para ver os detalhes da condição.

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsStepNameDynVar = "Set Dynamic Variables"
$tsStepDynVar = Get-CMTSStepSetDynamicVariable -InputObject $tsOsd -StepName $tsStepNameDynVar

Get-CMTSStepConditionSoftware -InputObject $tsStepDynVar

SmsProviderObjectPath : SMS_TaskSequence_SoftwareConditionExpression
Operator              : ThisVersion
ProductCode           : {B3842C82-95EB-472C-940A-D82C4A10857D}
ProductName           : Microsoft Endpoint Configuration Manager Console
UpgradeCode           : {B038D5E8-6C93-4A05-9E21-240324CFDF0E}
Version               : 5.2107.1059.1000

Exemplo 2: Copiar uma condição para outro passo

Este exemplo obtém primeiro a sequência de tarefas de implementação predefinida do SO e, em seguida, obtém o passo Definir Variáveis Dinâmicas . Transmite o objeto do passo da sequência de tarefas para este cmdlet e guarda o objeto na variável $condition .

Em seguida, utiliza o cmdlet Set-CMTSStepSetVariable com o parâmetro AddCondition para adicionar esta mesma condição ao passo Definir Variável de Sequência de Tarefas .

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsStepNameDynVar = "Set Dynamic Variables"
$tsStepDynVar = Get-CMTSStepSetDynamicVariable -InputObject $tsOsd -StepName $tsStepNameDynVar

$condition = Get-CMTSStepConditionSoftware -InputObject $tsStepDynVar

$tsStepNameSetTSVar = "Set Task Sequence Variable"

Set-CMTSStepSetVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameSetTSVar -AddCondition $condition

Parâmetros

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. 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

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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

-InputObject

Especifique um objeto de passo de sequência de tarefas com uma condição de software. Para obter este objeto, utilize um dos cmdlets Get-CMTSStep . Por exemplo, Get-CMTSStepApplyDataImage.

Tipo:IResultObject
Aliases:TaskSequenceStep
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_SoftwareConditionExpression classe WMI de servidor.