New-CMTSStepCaptureUserState
Создайте шаг Capture User State, который можно добавить в последовательность задач.
Синтаксис
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>]
Описание
В этом комлете создается новый объект шагового состояния пользователя Capture. Затем используйте кодлет Add-CMTaskSequenceStep, чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в дополнительных сведениях о действиях по последовательности задач: Capture User State.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример1
В этом примере сначала получается объект пакета для средства миграции состояния пользователя (USMT). Следующая строка создает объект для шага Capture User State, который использует пакет 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.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFile
При указании настройки записи профилей пользователей используйте этот параметр для указания имен файлов пользовательских -ModeOption Customize
файлов конфигурации XML. Эти файлы должны быть в пакете USMT.
Type: | String[] |
Aliases: | ConfigFiles |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Добавьте этот параметр, чтобы включить параметр Шаг Продолжить ошибку. Когда вы включаете этот параметр, если шаг не удается, последовательность задач продолжается.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnLockedFile
При указании установите этот параметр, чтобы разрешить -FileAccessOption Normal
продолжение USMT, если некоторые файлы не могут быть $true
захвачены.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Укажите необязательное описание для этого шага последовательности задач.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileAccessOption
Существует два варианта доступа USMT к файловой системе:
Normal
. USMT использует стандартный доступ к файловой системе. При указании этого параметра можно также включить ContinueOnLockedFile, OfflineUserStateи - .VolumeCopyShadowService
. USMT использует службы теневых копий тома (VSS).
Type: | FileAccessType |
Accepted values: | Normal, VolumeCopyShadowService |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModeOption
Существует два режима, в которых usMT может работать:
Standard
: Захват всех профилей пользователей с помощью стандартных параметров. Этот параметр является по умолчанию.Customize
: Настройка того, как захватываются профили пользователей. Если указан этот параметр, используйте параметр ConfigFile для указания настраиваемого XML-файлов конфигурации.
Type: | ModeType |
Accepted values: | Standard, Customize |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Укажите имя для этого шага, чтобы идентифицировать его в последовательности задач.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OfflineUserState
При указании установите этот параметр для захвата в автономном режиме -FileAccessOption Normal
$true
в Windows PE.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
Укажите объект для пакета USMT. Чтобы получить этот объект, используйте комлет Get-CMPackage.
Type: | IResultObject |
Aliases: | UserStateMigrationToolPackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipEncryptedFile
Установите этот параметр, чтобы пропустить файлы, которые используют файловую систему шифрования $true
(EFS).
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseHardLinks
При указании установите этот параметр для локального захвата с помощью жестких ссылок -FileAccessOption Normal
$true
NTFS.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLogging
Установите этот $true
параметр, чтобы включить подробный журнал USMT.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Отключение
Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Нет
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в SMS_TaskSequence_CaptureUserStateAction класса WMI сервера.