New-CMTSStepConditionOperatingSystem

  • Referência
Módulo:
ConfigurationManager

Crie uma condição de versão do SO para um passo de sequência de tarefas.

Sintaxe

New-CMTSStepConditionOperatingSystem
   -SupportedPlatform <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para criar um objeto de condição de versão do SO para um passo de sequência de tarefas. Em seguida, utilize um dos cmdlets New-CMTSStep* ou Set-CMTSStep* 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

Este exemplo utiliza primeiro o cmdlet Get-CMSupportedPlatform para criar um objeto de plataforma suportado que inclui clientes windows 10 e Windows 11 de 64 bits. Em seguida, utiliza esse objeto para criar o objeto de condição de passo de sequência de tarefas.

Em seguida, utiliza o cmdlet Set-CMTSStepSetDynamicVariable para adicionar este objeto de condição ao passo Definir Variáveis Dinâmicas da sequência de tarefas de implementação do SO Predefinido .

$osPlat = Get-CMSupportedPlatform -Name "*Windows 1? (64-bit) Client" -Fast

$condition = New-CMTSStepConditionOperatingSystem -SupportedPlatform $osPlat

$tsNameOsd = "Default OS deployment"
$tsStepNameDynVar = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameDynVar -AddCondition $condition

Este script de exemplo cria a seguinte condição no passo:

Operating System equals All Windows 10 (64-bit) Or All Windows 11 (64-bit)

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

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

-SupportedPlatform

Especifique um ou mais objetos de plataforma suportados para esta condição. Para obter este objeto, utilize o cmdlet Get-CMSupportedPlatform .

Tipo:IResultObject[]
Aliases:SupportedPlatforms
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 este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_OSConditionGroup classe WMI de servidor.

Para criar uma condição de idioma do SO, utilize o cmdlet New-CMTSStepConditionOperatingSystemLanguage .