New-CMTSStepRequestStateStore

Модуль:

ConfigurationManager

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

Синтаксис

New-CMTSStepRequestStateStore
   [-FallbackToAccount <Boolean>]
   [-RequestOption <RequestType>]
   [-RetryCount <Int32>]
   [-RetryTime <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

Пример 1

В этом примере создается объект для шага "Запросить хранилище состояний" для отслеживания состояния пользователя и указываются типичные параметры.

Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 11.

$step = New-CMTSStepRequestStateStore -Name "Request State Store" -RequestOption Capture -FallbackToAccount $false -RetryCount 3 -RetryTime 60

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Параметры

-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

-FallbackToAccount

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

Дополнительные сведения см. в статье Учетная запись доступа к сети.

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

-ForceWildcardHandling

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

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

-Name

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

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

-RequestOption

Укажите причину запроса доступа к точке миграции состояния:

• Capture: запись состояния с компьютера. Если на сайте Configuration Manager есть несколько активных точек миграции состояния, этот шаг находит точку миграции состояния с доступным местом на диске. Последовательность задач запрашивает у точки управления список точек миграции состояния, а затем оценивает каждую из них, пока не найдет ту, которая соответствует минимальным требованиям.

• Restore: восстановление состояния с другого компьютера. При наличии нескольких точек миграции состояния этот шаг находит точку миграции состояния, которая имеет состояние для конечного компьютера.

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

-RetryCount

Укажите количество попыток, когда этот шаг пытается найти соответствующую точку миграции состояния перед сбоем.

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

-RetryTime

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

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

-WhatIf

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

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

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

None

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

IResultObject

Примечания

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

Связанные ссылки

• Get-CMTSStepRequestStateStore
• Remove-CMTSStepRequestStateStore
• Set-CMTSStepRequestStateStore
• Сведения о шагах последовательности задач: хранилище состояний запроса