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

New-CMTSStepCaptureUserState

  • Ссылка
Модуль:
ConfigurationManager

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

Синтаксис

New-CMTSStepCaptureUserState
   [-ConfigFile <String[]>]
   [-ContinueOnLockedFile <Boolean>]
   [-FileAccessOption <FileAccessType>]
   [-ModeOption <ModeType>]
   [-OfflineUserState <Boolean>]
   -Package <IResultObject>
   [-SkipEncryptedFile <Boolean>]
   [-UseHardLinks <Boolean>]
   [-VerboseLogging <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

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

Примечание.

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

Примеры

Пример 1

В этом примере сначала возвращается объект пакета для средства миграции пользовательской среды (USMT). В следующей строке создается объект для шага Запись состояния пользователя , который использует этот пакет USMT и настраивает несколько параметров шага. Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 11.

$pkgUsmt = Get-CMPackage -Name "User State Migration Tool for Windows" -Fast

$step = New-CMTSStepCaptureUserState -Name "Capture User State" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -FileAccessOption Normal -ContinueOnLockedFile $true -UseHardLinks $true

$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

-ConfigFile

При указании -ModeOption Customize настройки способа отслеживания профилей пользователей используйте этот параметр, чтобы указать имена файлов пользовательских XML-файлов конфигурации. Эти файлы должны находиться в пакете USMT.

Тип:String[]
Aliases:ConfigFiles
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

-ContinueOnLockedFile

При указании -FileAccessOption Normalзадайте для этого параметра $true значение , чтобы разрешить USMT продолжать работу, если некоторые файлы не удается записать.

Тип:Boolean
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

-FileAccessOption

Существует два варианта доступа USMT к файловой системе:

  • Normal: USMT использует стандартный доступ к файловой системе. При указании этого параметра можно также включить ContinueOnLockedFile, OfflineUserState и -.

  • VolumeCopyShadowService: USMT использует теневую службу копирования томов (VSS).

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

-ForceWildcardHandling

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

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

-ModeOption

Существует два режима, в которых usMT может работать:

  • Standard: запись всех профилей пользователей с помощью стандартных параметров. Этот параметр используется по умолчанию.

  • Customize: настройка способа отслеживания профилей пользователей. Если этот параметр задан, используйте параметр ConfigFile , чтобы указать пользовательские XML-файлы конфигурации.

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

-Name

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

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

-OfflineUserState

При указании -FileAccessOption Normalзадайте для этого параметра значение $true для записи в автономном режиме в Среде предустановки Windows.

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

-Package

Укажите объект для пакета USMT. Чтобы получить этот объект, используйте командлет Get-CMPackage .

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

-SkipEncryptedFile

Присвойте этому параметру значение , $true чтобы пропустить файлы, использующие шифрующую файловую систему (EFS).

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

-UseHardLinks

При указании -FileAccessOption Normalзадайте для этого параметра $true значение для локальной записи с помощью жестких ссылок NTFS.

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

-VerboseLogging

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

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

-WhatIf

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

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

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

None

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

IResultObject

Примечания

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