New-CMTSStepPrestartCheck
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.
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