Compartir a través de


New-CMTSStepPrestartCheck

Cree un paso Comprobar preparación , que puede agregar a una secuencia de tareas.

Sintaxis

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 crea un nuevo objeto de paso Check Readiness . A continuación, use el cmdlet Add-CMTaskSequenceStep para agregar el paso a una secuencia de tareas. Para obtener más información sobre este paso, vea Acerca de los pasos de secuencia de tareas: Comprobar preparación.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1

En este ejemplo, primero se salpican los parámetros del cmdlet en la variable parameters .

A continuación, crea un objeto para el paso Comprobar preparación , pasando la colección de valores en parámetros.

A continuación, obtiene un objeto de secuencia de tareas y agrega este nuevo paso a la secuencia de tareas en el í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

Establezca este parámetro $true en para habilitar la comprobación de la versión mínima del cliente . Use el parámetro CMClientMinVersion para establecer el número de versión de cliente específico.

Tipo:Boolean
Alias:CheckClientMinVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckMaxOSVersion

Establezca este parámetro $true en para habilitar la comprobación de la versión máxima del sistema operativo . Use el parámetro MaxOSVersion para establecer el número de versión del sistema operativo específico.

Tipo:Boolean
Alias:EnableCheckMaxOSVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckMemory

Establezca este parámetro $true en para habilitar la comprobación memoria mínima (MB). Use el parámetro Memory para establecer el tamaño de memoria específico.

Tipo:Boolean
Alias:EnableCheckMemory
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckMinOSVersion

Establezca este parámetro $true en para habilitar la comprobación de versión mínima del sistema operativo . Use el parámetro MinOSVersion para establecer el número de versión del sistema operativo específico.

Tipo:Boolean
Alias:EnableCheckMinOSVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckNetworkConnected

Establezca este parámetro $true en para habilitar la comprobación de conexión del adaptador de red .

Tipo:Boolean
Alias:NetworkConnected
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckNetworkWired

Establezca este parámetro $true en para habilitar el adaptador de red no es una comprobación inalámbrica.

Tipo:Boolean
Alias:NetworkWired
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckOS

Establezca este parámetro $true en para habilitar la comprobación del tipo de sistema operativo, ya sea cliente o servidor. Use el sistema operativo del parámetro para establecer el tipo de sistema operativo específico.

Tipo:Boolean
Alias:EnableCheckOSType
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckOSArchitecture

Establezca este parámetro $true en para habilitar la comprobación de arquitectura del sistema operativo actual . Use el parámetro OSArchitecture para establecer el tipo de arquitectura específico.

Tipo:Boolean
Alias:EnableCheckOSArchitecture
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckOSLanguageId

Establezca este parámetro $true en para habilitar la comprobación del idioma del sistema operativo actual. Use el parámetro OSLanguageID para establecer el idioma específico.

Tipo:Boolean
Alias:EnableOSLanguageId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckPowerState

Establezca este parámetro $true en para habilitar la alimentación de CA conectada.

Tipo:Boolean
Alias:NotBattery
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckSpace

Establezca este parámetro $true en para habilitar la comprobación Mínimo de espacio libre en disco (MB ). Use el parámetro DiskSpace para establecer el tamaño específico.

Tipo:Boolean
Alias:EnableCheckFreeDiskSpace
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckSpeed

Establezca este parámetro $true en para habilitar la comprobación velocidad mínima del procesador (MHz ). Use el parámetro Speed para establecer la velocidad específica.

Tipo:Boolean
Alias:EnableCheckProcessorSpeed
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckTpmActivated

Se aplica a la versión 2111 y versiones posteriores. Establezca este parámetro $true en para habilitar la comprobación de TPM 2.0 o posterior .

Tipo:Boolean
Alias:TpmActivated
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckTpmEnabled

Se aplica a la versión 2111 y versiones posteriores. Establezca este parámetro $true en para habilitar la comprobación de TPM 2.0 o posterior .

Tipo:Boolean
Alias:TpmEnabled
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CheckUefi

Se aplica a la versión 2006 y versiones posteriores. Establezca este parámetro $true en para habilitar que el equipo esté en la comprobación del modo UEFI .

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CMClientMinVersion

Use este parámetro para configurar la versión de cliente específica. Especifique la versión del cliente en el formato siguiente: 5.00.8913.1005. Use el parámetro CheckCMClientMinVersion para habilitar o deshabilitar la comprobación.

Tipo:String
Alias:ClientMinVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Condition

Especifique un objeto de condición que se usará con este paso. Para obtener este objeto, use uno de los cmdlets de condición de secuencia de tareas. Por ejemplo, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Alias:Conditions
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ContinueOnError

Agregue este parámetro para habilitar la opción de paso Continuar en caso de error. Al habilitar esta opción, si se produce un error en el paso, la secuencia de tareas continúa.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifique una descripción opcional para este paso de secuencia de tareas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Disable

Agregue este parámetro para deshabilitar este paso de secuencia de tareas.

Tipo:SwitchParameter
Alias:DisableThisStep
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DiskSpace

Use este parámetro para configurar el tamaño específico de la comprobación mínima de espacio libre en disco. Especifique un valor entero para el tamaño en MB. Use el parámetro CheckSpace para habilitar o deshabilitar la comprobación.

Tipo:Int32
Alias:MinimumFreeDiskSpace
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxOSVersion

Use este parámetro para configurar la versión específica del sistema operativo. Especifique la versión máxima del sistema operativo con la versión principal, la versión secundaria y el número de compilación. Por ejemplo, 10.0.18356. Use el parámetro CheckMaxOSVersion para habilitar o deshabilitar la comprobación.

Tipo:String
Alias:CurrentMaxOSVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Memory

Use este parámetro para configurar el tamaño específico de la comprobación de memoria mínima. Especifique un valor entero para el tamaño en MB. Use el parámetro CheckMemory para habilitar o deshabilitar la comprobación.

Tipo:Int32
Alias:MinimumMemory
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MinOSVersion

Use este parámetro para configurar la versión específica del sistema operativo. Especifique la versión mínima del sistema operativo con la versión principal, la versión secundaria y el número de compilación. Por ejemplo, 10.0.16299. Use el parámetro CheckMinOSVersion para habilitar o deshabilitar la comprobación.

Tipo:String
Alias:CurrentMinOSVersion
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifique un nombre para este paso para identificarlo en la secuencia de tareas.

Tipo:String
Alias:StepName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OS

Use este parámetro para configurar el tipo de sistema operativo específico: Client o Server. Use el parámetro CheckOS para habilitar o deshabilitar la comprobación.

Tipo:OSType
Alias:CurrentOSType
Valores aceptados:Client, Server
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OSArchitecture

Use este parámetro para configurar la arquitectura específica del sistema operativo: Arch32 para 32 bits o Arch64 para 64 bits. Use el parámetro CheckOSArchitecture para habilitar o deshabilitar la comprobación.

Tipo:OSArch
Alias:CurrentOSArchitecture
Valores aceptados:Arch32, Arch64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OSLanguageId

Use este parámetro para configurar el lenguaje del sistema operativo específico. Esta comprobación compara el identificador de idioma con la propiedad OSLanguage de la clase WMI de Win32_OperatingSystem en el cliente. Por ejemplo, 1033 para inglés (Estados Unidos). Use el parámetro CheckOSLanguageId para habilitar o deshabilitar la comprobación.

Tipo:Int32
Alias:LanguageId
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Speed

Use este parámetro para configurar la velocidad específica para la comprobación de velocidad mínima del procesador. Especifique un valor entero para la velocidad en MHz. Use el parámetro CheckSpeed para habilitar o deshabilitar la comprobación.

Tipo:Int32
Alias:MinimumProcessorSpeed
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_PrestartCheckAction clase WMI de servidor.