New-CMTSStepCaptureWindowsSettings

Erstellen Sie einen Capture-Windows Einstellungen Schritt, den Sie einer Tasksequenz hinzufügen können.

Syntax

New-CMTSStepCaptureWindowsSettings
   [-MigrateComputerName <Boolean>]
   [-MigrateRegistrationInfo <Boolean>]
   [-MigrateTimeZone <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Dieses Cmdlet erstellt ein neues Capture Windows Einstellungen Step-Objekt. Verwenden Sie dann das Cmdlet "Add-CMTaskSequenceStep", um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu den Schritten in der Tasksequenz: Erfassen Windows Einstellungen.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel1

In diesem Beispiel wird zunächst ein Objekt für den Schritt "Erfassen Windows Einstellungen" erstellt, das alle Migrationsoptionen aktiviert.

Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz bei Index 11 hinzu.

$step = New-CMTSStepCaptureWindowsSettings -Name "Capture Windows Settings" -MigrateComputerName $true -MigrateRegistrationInfo $true -MigrateTimeZone $true

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

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

Parameter

-Bedingung

Geben Sie ein Bedingungsobjekt an, das für diesen Schritt verwendet werden soll. Um dieses Objekt abzurufen, verwenden Sie eines der Cmdlets für die Tasksequenzbedingung. Beispiel: Get-CMTSStepConditionVariable.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-ContinueOnError

Fügen Sie diesen Parameter hinzu, um die Schrittoption "Continue on error" zu aktivieren. Wenn Sie diese Option aktivieren, wird die Tasksequenz fortgesetzt, wenn der Schritt fehlschlägt.

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

-Description

Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.

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

-Disable

Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-MigrateComputerName

Legen Sie diesen Parameter $true fest, um den NetBIOS-Computernamen des Computers zu erfassen.

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

-MigrateRegistrationInfo

Legen Sie diesen Parameter $true fest, um die registrierten Benutzer- und Organisationsnamen vom Computer zu erfassen.

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

-MigrateTimeZone

Legen Sie diesen Parameter $true fest, um die Zeitzoneneinstellung auf dem Computer zu erfassen.

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

-Name

Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Keine

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_CaptureWindowsSettingsAction Server-WMI-Klasse.