New-CMTSStepCaptureSystemImage
Erstellen Sie einen Schritt Betriebssystemimage erfassen , den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepCaptureSystemImage
[-ImageCreator <String>]
[-ImageDescription <String>]
[-ImageVersion <String>]
[-Password <SecureString>]
-Path <String>
-UserName <String>
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt ein neues Capture Os Image-Schrittobjekt . Verwenden Sie dann das Cmdlet Add-CMTaskSequenceStep , um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu Tasksequenzschritten: Erfassen eines Betriebssystemimages.
Hinweis
Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>
B. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
In diesem Beispiel wird zunächst das integrierte Cmdlet ConvertTo-SecureString verwendet, um eine sichere Zeichenfolge für das Benutzerkennwort zu erstellen. Diese Methode wird hier als einfaches Beispiel verwendet, aber nicht die sicherste, da das Nur-Text-Kennwort im Skript enthalten ist. Weitere Informationen zu diesem Cmdlet und anderen Optionen finden Sie unter ConvertTo-SecureString.
In der nächsten Zeile wird ein -Objekt für den Schritt Betriebssystemimage erfassen erstellt, wobei die Kennwortvariable für sichere Zeichenfolgen verwendet wird.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.
$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
$step = New-CMTSStepCaptureSystemImage -Name "Capture OS Image" -Path "\\server\share$\images\image.wim" -UserName "contoso\_osdcapture" -Password $Secure_String_Pwd -ImageCreator "Meaghan C" -ImageDescription "The Virginia moon image" -ImageVersion "1.3b"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Parameter
-Condition
Geben Sie ein Bedingungsobjekt an, das mit diesem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts eines der Tasksequenzbedingungs-Cmdlets. Beispiel: Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortfahren zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageCreator
Geben Sie den Namen des Benutzers an, der das Betriebssystemimage erstellt hat. Diese Zeichenfolge wird in der Bilddatei gespeichert.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageDescription
Geben Sie eine Beschreibung des erfassten Betriebssystemimages an. Diese Zeichenfolge wird in der Bilddatei gespeichert.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImageVersion
Geben Sie eine Versionsnummer an, die dem erfassten Betriebssystemimage zugewiesen werden soll. Dieser Wert kann eine beliebige Kombination aus Buchstaben und Zahlen sein. Sie wird in der Bilddatei gespeichert.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
Geben Sie das Kennwort für den UserName an, der über Berechtigungen für die Netzwerkfreigabe verfügt.
Type: | SecureString |
Aliases: | CapturePassword |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Geben Sie den Netzwerkpfad zu dem Speicherort an, den Configuration Manager beim Speichern des erfassten Betriebssystemimages verwendet.
Type: | String |
Aliases: | CaptureDestination |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Geben Sie den Benutzernamen des Kontos an, das über Die Berechtigung zum Schreiben in den Pfadspeicherort verfügt. Verwenden Sie auch den Parameter Password .
Weitere Informationen zu diesem Konto finden Sie unter Erfassen des Betriebssystemimagekontos.
Type: | String |
Aliases: | CaptureUserName |
Position: | Named |
Default value: | None |
Required: | True |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_CaptureSystemImageAction WMI-Serverklasse.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für