New-CMTSStepPrestartCheck

Referência

Módulo:: ConfigurationManager

Crie uma etapa de Preparação de Verificação , que você pode adicionar a uma sequência de tarefas.

Syntax

New-CMTSStepPrestartCheck
   [-CheckCMClientMinVersion <Boolean>]
   [-CheckMaxOSVersion <Boolean>]
   [-CheckMemory <Boolean>]
   [-CheckMinOSVersion <Boolean>]
   [-CheckNetworkConnected <Boolean>]
   [-CheckNetworkWired <Boolean>]
   [-CheckTpmEnabled <Boolean>]
   [-CheckTpmActivated <Boolean>]
   [-CheckOS <Boolean>]
   [-CheckOSArchitecture <Boolean>]
   [-CheckOSLanguageId <Boolean>]
   [-CheckPowerState <Boolean>]
   [-CheckSpace <Boolean>]
   [-CheckSpeed <Boolean>]
   [-CheckUefi <Boolean>]
   [-CMClientMinVersion <String>]
   [-DiskSpace <Int32>]
   [-MaxOSVersion <String>]
   [-Memory <Int32>]
   [-MinOSVersion <String>]
   [-OS <OSType>]
   [-OSArchitecture <OSArch>]
   [-OSLanguageId <Int32>]
   [-Speed <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria um novo objeto de etapa Verificar Preparação . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, confira Sobre as etapas da sequência de tarefas: Verificar Preparação.

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 primeiro coloca os parâmetros de cmdlet na variável de parâmetros .

Em seguida, ele cria um objeto para a etapa Verificar Preparação , passando a coleção de valores em parâmetros.

Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 11.

$parameters = @{
  Name = "Check Readiness"
  CheckMemory = $true
  Memory = 4096
  CheckSpeed = $true
  Speed = 1024
  CheckSpace = $true
  DiskSpace = 512000
  CheckOS = $true
  OS = "Client"
  CheckOSArchitecture = $true
  OSArchitecture = "Arch64"
  CheckMinOSVersion = $true
  MinOSVersion = "10.0.16299"
  CheckMaxOSVersion = $true
  MaxOSVersion = "10.0.99999"
  CheckCMClientMinVersion = $true
  CMClientMinVersion = "5.00.8913.1005"
  CheckOSLanguageId = $true
  OSLanguageID = 1033
  CheckPowerState = $true
  CheckNetworkConnected = $true
  CheckNetworkWired = $false
  CheckUefi = $true
}

$step = New-CMTSStepPrestartCheck @parameters

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

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Parâmetros

-CheckCMClientMinVersion

Defina esse parâmetro para $true habilitar a verificação de versão mínima do cliente . Use o parâmetro CMClientMinVersion para definir o número de versão do cliente específico.

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

-CheckMaxOSVersion

Defina esse parâmetro para $true habilitar a verificação de versão máxima do sistema operacional . Use o parâmetro MaxOSVersion para definir o número de versão do sistema operacional específico.

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

-CheckMemory

Defina esse parâmetro para $true habilitar a verificação de memória mínima (MB). Use o parâmetro Memória para definir o tamanho da memória específico.

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

-CheckMinOSVersion

Defina esse parâmetro para $true habilitar a verificação de versão mínima do sistema operacional . Use o parâmetro MinOSVersion para definir o número de versão do sistema operacional específico.

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

-CheckNetworkConnected

Defina esse parâmetro para $true habilitar a verificação conectada do adaptador de rede.

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

-CheckNetworkWired

Defina esse parâmetro para $true habilitar que o adaptador de rede não é uma verificação sem fio.

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

-CheckOS

Defina esse parâmetro para $true habilitar a verificação do tipo de sistema operacional, cliente ou servidor. Use o sistema operacional de parâmetro para definir o tipo de sistema operacional específico.

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

-CheckOSArchitecture

Defina esse parâmetro para $true habilitar a verificação de arquitetura do sistema operacional atual . Use o parâmetro OSArchitecture para definir o tipo de arquitetura específico.

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

-CheckOSLanguageId

Defina esse parâmetro para $true habilitar a verificação da linguagem do sistema operacional atual. Use o parâmetro OSLanguageID para definir o idioma específico.

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

-CheckPowerState

Defina esse parâmetro para $true habilitar a verificação da energia de AC conectada .

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

-CheckSpace

Defina esse parâmetro para $true habilitar a verificação de espaço em disco livre mínimo (MB). Use o parâmetro DiskSpace para definir o tamanho específico.

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

-CheckSpeed

Defina esse parâmetro para $true habilitar a verificação de velocidade mínima do processador (MHz ). Use o parâmetro Velocidade para definir a velocidade específica.

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

-CheckTpmActivated

Aplica-se à versão 2111 e posterior. Defina esse parâmetro para $true habilitar a verificação ativada do TPM 2.0 ou superior .

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

-CheckTpmEnabled

Aplica-se à versão 2111 e posterior. Defina esse parâmetro para $true habilitar a verificação do TPM 2.0 ou superior habilitada .

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

-CheckUefi

Aplica-se à versão 2006 e posterior. Defina esse parâmetro para $true habilitar que o computador esteja em verificação de modo UEFI .

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

-CMClientMinVersion

Use esse parâmetro para configurar a versão específica do cliente. Especifique a versão do cliente no seguinte formato: 5.00.8913.1005. Use o parâmetro CheckCMClientMinVersion para habilitar ou desabilitar a verificação.

Type:	String
Aliases:	ClientMinVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Condition

Especifique um objeto de condição a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.

Type:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-ContinueOnError

Adicione esse parâmetro para habilitar a opção de etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.

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

-Description

Especifique uma descrição opcional para esta etapa de sequência de tarefas.

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

-Disable

Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-DiskSpace

Use esse parâmetro para configurar o tamanho específico para a verificação mínima de espaço em disco livre. Especifique um valor inteiro para o tamanho em MB. Use o parâmetro CheckSpace para habilitar ou desabilitar a verificação.

Type:	Int32
Aliases:	MinimumFreeDiskSpace
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-MaxOSVersion

Use esse parâmetro para configurar a versão específica do sistema operacional. Especifique a versão máxima do sistema operacional com a versão principal, a versão secundária e o número de build. Por exemplo, 10.0.18356. Use o parâmetro CheckMaxOSVersion para habilitar ou desabilitar a verificação.

Type:	String
Aliases:	CurrentMaxOSVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Memory

Use esse parâmetro para configurar o tamanho específico para a verificação de memória mínima. Especifique um valor inteiro para o tamanho em MB. Use o parâmetro CheckMemory para habilitar ou desabilitar a verificação.

Type:	Int32
Aliases:	MinimumMemory
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinOSVersion

Use esse parâmetro para configurar a versão específica do sistema operacional. Especifique a versão mínima do sistema operacional com a versão principal, a versão secundária e o número de build. Por exemplo, 10.0.16299. Use o parâmetro CheckMinOSVersion para habilitar ou desabilitar a verificação.

Type:	String
Aliases:	CurrentMinOSVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.

Type:	String
Aliases:	StepName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OS

Use esse parâmetro para configurar o tipo de sistema operacional específico: Client ou Server. Use o parâmetro CheckOS para habilitar ou desabilitar a verificação.

Type:	OSType
Aliases:	CurrentOSType
Accepted values:	Client, Server
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSArchitecture

Use esse parâmetro para configurar a arquitetura específica do sistema operacional: Arch32 para 32 bits ou Arch64 para 64 bits. Use o parâmetro CheckOSArchitecture para habilitar ou desabilitar a verificação.

Type:	OSArch
Aliases:	CurrentOSArchitecture
Accepted values:	Arch32, Arch64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSLanguageId

Use esse parâmetro para configurar o idioma específico do sistema operacional. Essa verificação compara a ID do idioma com a propriedade OSLanguage da classe WMI Win32_OperatingSystem no cliente. Por exemplo, 1033 para inglês (Estados Unidos). Use o parâmetro CheckOSLanguageId para habilitar ou desabilitar a verificação.

Type:	Int32
Aliases:	LanguageId
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Speed

Use esse parâmetro para configurar a velocidade específica para a verificação de velocidade mínima do processador. Especifique um valor inteiro para a velocidade em MHz. Use o parâmetro CheckSpeed para habilitar ou desabilitar a verificação.

Type:	Int32
Aliases:	MinimumProcessorSpeed
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_PrestartCheckAction classe WMI do servidor.