New-CMTSStepPrestartCheck

Ссылка

Модуль:: ConfigurationManager

Создайте шаг проверки готовности , который можно добавить в последовательность задач.

Синтаксис

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>]

Описание

Этот командлет создает новый объект шага проверки готовности . Затем используйте командлет Add-CMTaskSequenceStep , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: Проверка готовности.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1

В этом примере сначала параметры командлета объединяются в переменную parameters .

Затем он создает объект для шага Проверить готовность , передав коллекцию значений в параметрах.

Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 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

Параметры

-CheckCMClientMinVersion

Задайте для этого параметра значение , $true чтобы включить проверку минимальной версии клиента . Используйте параметр CMClientMinVersion , чтобы задать конкретный номер версии клиента.

Тип:	Boolean
Aliases:	CheckClientMinVersion
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckMaxOSVersion

Присвойте этому параметру значение , $true чтобы включить проверку максимальной версии ОС . Используйте параметр MaxOSVersion , чтобы задать номер конкретной версии ОС.

Тип:	Boolean
Aliases:	EnableCheckMaxOSVersion
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckMemory

Присвойте этому параметру значение , $true чтобы включить проверку минимальной памяти (МБ). Используйте параметр Memory , чтобы задать конкретный размер памяти.

Тип:	Boolean
Aliases:	EnableCheckMemory
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckMinOSVersion

Задайте для этого параметра значение , $true чтобы включить проверку минимальной версии ОС . Используйте параметр MinOSVersion , чтобы задать номер конкретной версии ОС.

Тип:	Boolean
Aliases:	EnableCheckMinOSVersion
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckNetworkConnected

Присвойте этому параметру значение , $true чтобы включить проверку подключения сетевого адаптера .

Тип:	Boolean
Aliases:	NetworkConnected
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckNetworkWired

Присвойте этому параметру значение , $true чтобы включить проверку сетевого адаптера не является беспроводной .

Тип:	Boolean
Aliases:	NetworkWired
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckOS

Присвойте этому параметру значение , $true чтобы включить проверку типа ОС, клиента или сервера. Используйте параметр ОС , чтобы задать конкретный тип ОС.

Тип:	Boolean
Aliases:	EnableCheckOSType
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckOSArchitecture

Присвойте этому параметру значение , $true чтобы включить проверку архитектуры текущей ОС . Используйте параметр OSArchitecture , чтобы задать конкретный тип архитектуры.

Тип:	Boolean
Aliases:	EnableCheckOSArchitecture
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckOSLanguageId

Присвойте этому параметру значение , $true чтобы включить проверку языка текущей ОС. Используйте параметр OSLanguageID , чтобы задать конкретный язык.

Тип:	Boolean
Aliases:	EnableOSLanguageId
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckPowerState

Присвойте этому параметру значение , $true чтобы включить проверку питания, подключенного к сети.

Тип:	Boolean
Aliases:	NotBattery
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckSpace

Задайте для этого параметра значение, $true чтобы включить флажок Минимальное свободное место на диске (МБ). Используйте параметр DiskSpace , чтобы задать конкретный размер.

Тип:	Boolean
Aliases:	EnableCheckFreeDiskSpace
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckSpeed

Задайте для этого параметра значение , $true чтобы включить флажок Минимальная частота процессора (МГц). Используйте параметр Speed , чтобы задать определенную скорость.

Тип:	Boolean
Aliases:	EnableCheckProcessorSpeed
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckTpmActivated

Применяется к версии 2111 и более поздним. Задайте этому параметру значение , $true чтобы включить проверку активации доверенного платформенного модуля 2.0 или более поздней версии .

Тип:	Boolean
Aliases:	TpmActivated
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckTpmEnabled

Применяется к версии 2111 и более поздним. Присвойте этому параметру значение , $true чтобы включить проверку включения доверенного платформенного модуля 2.0 или более поздней версии .

Тип:	Boolean
Aliases:	TpmEnabled
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CheckUefi

Применяется к версии 2006 и более поздним. Задайте для этого параметра значение , $true чтобы включить проверку компьютера в режиме UEFI .

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CMClientMinVersion

Используйте этот параметр для настройки конкретной версии клиента. Укажите версию клиента в следующем формате: 5.00.8913.1005. Используйте параметр CheckCMClientMinVersion , чтобы включить или отключить проверку.

Тип:	String
Aliases:	ClientMinVersion
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Condition

Укажите объект условия для использования на этом шаге. Чтобы получить этот объект, используйте один из командлетов условия последовательности задач. Например, Get-CMTSStepConditionVariable.

Тип:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ContinueOnError

Добавьте этот параметр, чтобы включить параметр шага Продолжить при ошибке. Если этот параметр включен, если шаг завершается ошибкой, последовательность задач продолжается.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Description

Укажите необязательное описание для этого шага последовательности задач.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Disable

Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.

Тип:	SwitchParameter
Aliases:	DisableThisStep
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DiskSpace

Используйте этот параметр, чтобы настроить конкретный размер для проверки минимального свободного места на диске. Укажите целочисленное значение для размера в МБ. Используйте параметр CheckSpace , чтобы включить или отключить проверку.

Тип:	Int32
Aliases:	MinimumFreeDiskSpace
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaxOSVersion

Используйте этот параметр для настройки конкретной версии ОС. Укажите максимальную версию ОС с основной, дополнительной версией и номером сборки. Например, 10.0.18356. Используйте параметр CheckMaxOSVersion , чтобы включить или отключить проверку.

Тип:	String
Aliases:	CurrentMaxOSVersion
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Memory

Используйте этот параметр, чтобы настроить конкретный размер для минимальной проверки памяти. Укажите целочисленное значение для размера в МБ. Используйте параметр CheckMemory , чтобы включить или отключить проверку.

Тип:	Int32
Aliases:	MinimumMemory
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MinOSVersion

Используйте этот параметр для настройки конкретной версии ОС. Укажите минимальную версию ОС с основной, дополнительной версией и номером сборки. Например, 10.0.16299. Используйте параметр CheckMinOSVersion , чтобы включить или отключить проверку.

Тип:	String
Aliases:	CurrentMinOSVersion
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Укажите имя для этого шага, чтобы определить его в последовательности задач.

Тип:	String
Aliases:	StepName
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OS

Используйте этот параметр для настройки определенного типа ОС: Client или Server. Используйте параметр CheckOS , чтобы включить или отключить проверку.

Тип:	OSType
Aliases:	CurrentOSType
Допустимые значения:	Client, Server
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OSArchitecture

Используйте этот параметр для настройки конкретной архитектуры ОС: Arch32 для 32-разрядной или Arch64 64-разрядной. Используйте параметр CheckOSArchitecture , чтобы включить или отключить проверку.

Тип:	OSArch
Aliases:	CurrentOSArchitecture
Допустимые значения:	Arch32, Arch64
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OSLanguageId

Используйте этот параметр для настройки определенного языка ОС. Эта проверка сравнивает идентификатор языка со свойством OSLanguageкласса WMI Win32_OperatingSystem на клиенте. Например, 1033 для английского языка (США). Используйте параметр CheckOSLanguageId , чтобы включить или отключить проверку.

Тип:	Int32
Aliases:	LanguageId
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Speed

Используйте этот параметр для настройки конкретной скорости для проверки минимальной скорости процессора. Укажите целочисленное значение для скорости в МГц. Используйте параметр CheckSpeed , чтобы включить или отключить проверку.

Тип:	Int32
Aliases:	MinimumProcessorSpeed
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе класс WMI сервера SMS_TaskSequence_PrestartCheckAction.

Поделиться через