New-CMTSStepPrestartCheck
Crie um passo Verificar Preparação , que pode adicionar a uma sequência de tarefas.
Sintaxe
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 passo Verificar Preparação . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja Acerca dos passos da sequência de tarefas: Verificar a Preparação.
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 introduz primeiro os parâmetros do cmdlet na variável parameters .
Em seguida, cria um objeto para o passo Verificar Preparação , ao transmitir a coleção de valores em parâmetros.
Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à 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 11Parâmetros
-CheckCMClientMinVersion
Defina este parâmetro como $true para ativar a verificação da versão mínima do cliente . Utilize o parâmetro CMClientMinVersion para definir o número de versão do cliente específico.
| Tipo: | Boolean |
| Aliases: | CheckClientMinVersion |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckMaxOSVersion
Defina este parâmetro como para $true ativar a verificação da versão máxima do SO . Utilize o parâmetro MaxOSVersion para definir o número específico da versão do SO.
| Tipo: | Boolean |
| Aliases: | EnableCheckMaxOSVersion |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckMemory
Defina este parâmetro como $true para ativar a verificação Memória mínima (MB ). Utilize o parâmetro Memória para definir o tamanho de memória específico.
| Tipo: | Boolean |
| Aliases: | EnableCheckMemory |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckMinOSVersion
Defina este parâmetro como $true para ativar a verificação da versão mínima do SO . Utilize o parâmetro MinOSVersion para definir o número específico da versão do SO.
| Tipo: | Boolean |
| Aliases: | EnableCheckMinOSVersion |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckNetworkConnected
Defina este parâmetro como $true para ativar a verificação ligada do Adaptador de rede .
| Tipo: | Boolean |
| Aliases: | NetworkConnected |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckNetworkWired
Defina este parâmetro como para $true ativar a placa de rede não é uma verificação sem fios .
| Tipo: | Boolean |
| Aliases: | NetworkWired |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckOS
Defina este parâmetro como para $true ativar a verificação do tipo de SO, cliente ou servidor. Utilize o SO do parâmetro para definir o tipo de SO específico.
| Tipo: | Boolean |
| Aliases: | EnableCheckOSType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckOSArchitecture
Defina este parâmetro como $true para ativar a verificação Arquitetura do SO atual . Utilize o parâmetro OSArchitecture para definir o tipo de arquitetura específico.
| Tipo: | Boolean |
| Aliases: | EnableCheckOSArchitecture |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckOSLanguageId
Defina este parâmetro como $true para ativar a verificação do Idioma do SO atual. Utilize o parâmetro OSLanguageID para definir o idioma específico.
| Tipo: | Boolean |
| Aliases: | EnableOSLanguageId |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckPowerState
Defina este parâmetro como para $true ativar a verificação de alimentação CA ligada à corrente.
| Tipo: | Boolean |
| Aliases: | NotBattery |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckSpace
Defina este parâmetro como para $true ativar a verificação Espaço mínimo livre em disco (MB ). Utilize o parâmetro DiskSpace para definir o tamanho específico.
| Tipo: | Boolean |
| Aliases: | EnableCheckFreeDiskSpace |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckSpeed
Defina este parâmetro como $true para ativar a verificação Velocidade mínima do processador (MHz). Utilize o parâmetro Speed para definir a velocidade específica.
| Tipo: | Boolean |
| Aliases: | EnableCheckProcessorSpeed |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckTpmActivated
Aplica-se à versão 2111 e posterior. Defina este parâmetro como $true para ativar a verificação ativada do TPM 2.0 ou superior .
| Tipo: | Boolean |
| Aliases: | TpmActivated |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckTpmEnabled
Aplica-se à versão 2111 e posterior. Defina este parâmetro como para $true ativar a verificação TPM 2.0 ou superior ativada .
| Tipo: | Boolean |
| Aliases: | TpmEnabled |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CheckUefi
Aplica-se à versão 2006 e posterior. Defina este parâmetro como para $true ativar a verificação Computador no modo UEFI .
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CMClientMinVersion
Utilize este parâmetro para configurar a versão específica do cliente. Especifique a versão do cliente no seguinte formato: 5.00.8913.1005. Utilize o parâmetro CheckCMClientMinVersion para ativar ou desativar a verificação.
| Tipo: | String |
| Aliases: | ClientMinVersion |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Condition
Especifique um objeto de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
| Tipo: | IResultObject[] |
| Aliases: | Conditions |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-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 |
-ContinueOnError
Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Description
Especifique uma descrição opcional para este passo de sequência de tarefas.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Disable
Adicione este parâmetro para desativar este passo de sequência de tarefas.
| Tipo: | SwitchParameter |
| Aliases: | DisableThisStep |
| 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 |
-DiskSpace
Utilize este parâmetro para configurar o tamanho específico para a verificação de espaço em disco livre mínima. Especifique um valor inteiro para o tamanho em MB. Utilize o parâmetro CheckSpace para ativar ou desativar a verificação.
| Tipo: | Int32 |
| Aliases: | MinimumFreeDiskSpace |
| 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 |
-MaxOSVersion
Utilize este parâmetro para configurar a versão específica do SO. Especifique a versão máxima do SO com a versão principal, a versão secundária e o número de compilação. Por exemplo, 10.0.18356. Utilize o parâmetro CheckMaxOSVersion para ativar ou desativar a verificação.
| Tipo: | String |
| Aliases: | CurrentMaxOSVersion |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Memory
Utilize este 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. Utilize o parâmetro CheckMemory para ativar ou desativar a verificação.
| Tipo: | Int32 |
| Aliases: | MinimumMemory |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MinOSVersion
Utilize este parâmetro para configurar a versão específica do SO. Especifique a versão mínima do SO com a versão principal, a versão secundária e o número de compilação. Por exemplo, 10.0.16299. Utilize o parâmetro CheckMinOSVersion para ativar ou desativar a verificação.
| Tipo: | String |
| Aliases: | CurrentMinOSVersion |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifique um nome para este passo para identificá-lo na sequência de tarefas.
| Tipo: | String |
| Aliases: | StepName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OS
Utilize este parâmetro para configurar o tipo de SO específico: Client ou Server. Utilize o parâmetro CheckOS para ativar ou desativar a verificação.
| Tipo: | OSType |
| Aliases: | CurrentOSType |
| Valores aceitos: | Client, Server |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OSArchitecture
Utilize este parâmetro para configurar a arquitetura específica do SO: Arch32 para 32 bits ou Arch64 para 64 bits. Utilize o parâmetro CheckOSArchitecture para ativar ou desativar a verificação.
| Tipo: | OSArch |
| Aliases: | CurrentOSArchitecture |
| Valores aceitos: | Arch32, Arch64 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OSLanguageId
Utilize este parâmetro para configurar a linguagem específica do SO. Esta verificação compara o ID de idioma com a propriedade OSLanguage da classe WMI Win32_OperatingSystem no cliente. Por exemplo, 1033 para inglês (Estados Unidos). Utilize o parâmetro CheckOSLanguageId para ativar ou desativar a verificação.
| Tipo: | Int32 |
| Aliases: | LanguageId |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Speed
Utilize este 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. Utilize o parâmetro CheckSpeed para ativar ou desativar a verificação.
| Tipo: | Int32 |
| Aliases: | MinimumProcessorSpeed |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| 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_PrestartCheckAction classe WMI de servidor.