Get-CMTSStepCaptureSystemImage
Rufen Sie den Schritt Betriebssystemimage erfassen aus einer bestimmten Tasksequenz ab.
Syntax
Get-CMTSStepCaptureSystemImage
[-InputObject] <IResultObject>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepCaptureSystemImage
[-TaskSequenceId] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepCaptureSystemImage
[-TaskSequenceName] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Verwenden Sie dieses Cmdlet, um ein Tasksequenzschrittobjekt für eine oder mehrere Instanzen des Schritts Capture Os Image abzurufen. Sie können dieses Objekt für Folgendes verwenden:
- Entfernen des Schritts aus einer Tasksequenz mit Remove-CMTSStepCaptureSystemImage
- Kopieren des Schritts in eine andere Tasksequenz mit Add-CMTaskSequenceStep
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-Standortlaufwerk aus, z. B PS XYZ:\>
. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1
In diesem Beispiel wird zunächst ein Tasksequenzobjekt in der variablen $tsOsd abgerufen. Anschließend wird diese Variable als Eingabeobjekt übergeben, um den Schritt Betriebssystemimage erfassen abzurufen.
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameCapOSImg = "Capture OS Image"
$tsStepCapOSImg = Get-CMTSStepCaptureSystemImage -InputObject $tsOsd -StepName $tsStepNameCapOSImg
Parameter
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein Tasksequenzobjekt an, aus dem der Schritt Betriebssystemimage erfassen abgerufen werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMTaskSequence .
Typ: | IResultObject |
Aliase: | TaskSequence |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-StepName
Geben Sie den Namen des Schritts Betriebssystemimage erfassen an, der aus der Tasksequenz abgerufen werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TaskSequenceId
Geben Sie die Paket-ID der Tasksequenz an, aus der der Schritt Betriebssystemimage erfassen abgerufen werden soll. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00858
. .
Typ: | String |
Aliase: | Id, TaskSequencePackageId |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TaskSequenceName
Geben Sie den Namen der Tasksequenz an, aus der der Schritt Betriebssystemimage erfassen abgerufen werden soll.
Typ: | String |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object