New-CMTSStepPrestartCheck
Создайте шаг проверки готовности , который можно добавить в последовательность задач.
Синтаксис
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.