Partager via

New-CMTSStepCaptureUserState

  • Référence
Module:
ConfigurationManager

Créez une étape capturer l’état utilisateur, que vous pouvez ajouter à une séquence de tâches.

Syntax

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

Description

Cette cmdlet crée un objet d’étape Capture User State. Utilisez ensuite la cmdlet Add-CMTaskSequenceStep pour ajouter l’étape à une séquence de tâches. Pour plus d’informations sur cette étape, voir à propos des étapes de la séquence de tâches : Capturer l’état de l’utilisateur.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1

Cet exemple obtient d’abord un objet de package pour l’outil de migration utilisateur (USMT). La ligne suivante crée un objet pour l’étape Capturer l’état utilisateur, qui utilise ce package USMT et configure plusieurs paramètres d’étape. Il obtient ensuite un objet de séquence de tâches et ajoute cette nouvelle étape à la séquence de tâches à l’index 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

Paramètres

- Confirmer

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Condition

Spécifiez un objet condition à utiliser avec cette étape. Pour obtenir cet objet, utilisez l’une des cmdlets de condition de séquence de tâches. Par exemple, Get-CMTSStepConditionVariable.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ConfigFile

Lorsque vous spécifiez la façon dont les profils utilisateur sont capturés, utilisez ce paramètre pour spécifier les noms de fichiers des fichiers -ModeOption Customize de configuration XML personnalisés. Ces fichiers doivent se trouver dans le package USMT.

Type:String[]
Aliases:ConfigFiles
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnError

Ajoutez ce paramètre pour activer l’option d’étape Continuer sur l’erreur. Lorsque vous activez cette option, si l’étape échoue, la séquence de tâches se poursuit.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ContinueOnLockedFile

Lorsque vous -FileAccessOption Normal spécifiez , définissez ce paramètre pour autoriser l’usmt à continuer si certains fichiers $true ne peuvent pas être capturés.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Spécifiez une description facultative pour cette étape de séquence de tâches.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Disable

Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FileAccessOption

Deux options s’offrent à vous pour accéder au système de fichiers par l’usmt :

  • Normal: USMT utilise l’accès standard au système de fichiers. Lorsque vous spécifiez cette option, vous pouvez également activer ContinueOnLockedFile, OfflineUserStateet - .

  • VolumeCopyShadowService: l’usmt utilise les services VSS (Volume Copy Shadow Services).

Type:FileAccessType
Accepted values:Normal, VolumeCopyShadowService
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ModeOption

Il existe deux modes dans lesquels l’usMT peut fonctionner :

  • Standard: capturer tous les profils utilisateur à l’aide d’options standard. Cette option est activée par défaut.

  • Customize: personnaliser la façon dont les profils utilisateur sont capturés. Si vous spécifiez cette option, utilisez le paramètre ConfigFile pour spécifier les fichiers de configuration XML personnalisés.

Type:ModeType
Accepted values:Standard, Customize
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifiez un nom pour cette étape pour l’identifier dans la séquence de tâches.

Type:String
Aliases:StepName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-OfflineUserState

Lorsque vous spécifiez , définissez ce paramètre de façon à ce qu’il soit capturé en mode hors connexion -FileAccessOption Normal $true Windows PE.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Package

Spécifiez un objet pour le package USMT. Pour obtenir cet objet, utilisez l’cmdlet Get-CMPackage.

Type:IResultObject
Aliases:UserStateMigrationToolPackage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SkipEncryptedFile

Définissez ce paramètre pour ignorer les fichiers qui utilisent le système de fichiers de $true chiffrement (EFS).

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseHardLinks

Lorsque vous spécifiez , définissez ce paramètre pour capturer localement à -FileAccessOption Normal l’aide de liens $true NTFS en dur.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VerboseLogging

Définissez ce paramètre pour $true activer la journalisation détaillée de l’USMT.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Néant

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_TaskSequence_CaptureUserStateAction classe WMI du serveur.