New-CMTSStepApplyOperatingSystem
Erstellen Sie einen Schritt "Betriebssystemimage anwenden", den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepApplyOperatingSystem
[-ConfigFileName <String>]
[-ConfigFilePackage <IResultObject>]
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-LayeredDriver <OsdLayeredDriver>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
[-ImagePackage <IResultObject>]
[-ImagePackageIndex <Int32>]
[-InstallPackage <IResultObject>]
[-InstallPackageIndex <Int32>]
[-RunFromNet <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet erstellt ein neues Schrittobjekt für das Betriebssystemimage anwenden. 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: Anwenden des Betriebssystemimages.
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 das Cmdlet "Get-CMOperatingSystemImage" verwendet, um ein Objekt für das Betriebssystemimagepaket abzurufen. Dieses Objekt wird in der variablen $osImgPkg gespeichert. Im nächsten Schritt wird ein Objekt für den Schritt "Betriebssystemimage anwenden" erstellt, wobei das $osImgPkg-Objekt als Imagepaket verwendet wird.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz bei Index 11 hinzu.
$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1
$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 |
-ConfigFileName
Geben Sie den Dateinamen einer unbeaufsichtigten oder Sysprep-Antwortdatei an, die für eine benutzerdefinierte Installation verwendet werden soll. Verwenden Sie diesen Parameter mit dem Parameter ConfigFilePackage.
Type: | String |
Aliases: | AnswerFileName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFilePackage
Geben Sie ein Paketobjekt an, das die unbeaufsichtigte Antwortdatei oder sysprep-Antwortdatei enthält, die für eine benutzerdefinierte Installation verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMPackage". Verwenden Sie diesen Parameter mit dem Parameter ConfigFileName.
Type: | IResultObject |
Aliases: | AnswerFilePackage |
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 |
-Destination
Geben Sie den Speicherort an, an dem Sie dieses Betriebssystem anwenden möchten. Wenn Sie diesen Parameter nicht angeben, lautet der Standardwert NextAvailableFormattedPartition
.
NextAvailableFormattedPartition
: Verwenden Sie die nächste sequenzielle Partition, auf die noch kein Betriebssystem angewendet wurde, oder wenden Sie in dieser Tasksequenz den Schritt "Datenabbild anwenden" an.SpecificDiskAndPartition
: Geben Sie die Datenträgernummer mit dem Parameter "DestinationDisk" und die Partitionsnummer mit dem Parameter "DestinationPartition" an.SpecificLogicalDriverLetter
: Verwenden Sie den Parameter DestinationDriveLetter, um den logischen Laufwerkbuchstaben anzugeben, der der Partition von Windows PE zugewiesen wurde. Dieser Laufwerkbuchstabe kann sich von dem Laufwerkbuchstaben unterscheiden, der vom neu bereitgestellten Betriebssystem zugewiesen wurde.LogicalDriverLetterInVariable
: Verwenden Sie den Parameter DestinationVariable, um die Tasksequenzvariable anzugeben, die den Laufwerkbuchstaben enthält, der der Partition von Windows PE zugewiesen wurde. Diese Variable wird in der Regel mit dem DiskNumberVariable-Parameter der Cmdlets "Set-CMTSStepPartitionDisk" oder "New-CMTSStepPartitionDisk" für den Tasksequenzschritt "Format" und "Partition Disk" festgelegt.
Type: | DestinationType |
Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDisk
Wenn Sie diesen Parameter verwenden, geben Sie -Destination SpecificDiskAndPartition
die Datenträgernummer an. Geben Sie eine ganze Zahl von 0
bis 99
. Verwenden Sie auch den Parameter "DestinationPartition".
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationDriveLetter
Wenn Sie diesen Parameter verwenden, geben Sie -Destination SpecificLogicalDriverLetter
den logischen Laufwerkbuchstaben an. Geben Sie einen Laufwerkbuchstaben von C
bis Z
an.
Type: | String |
Aliases: | DestinationLogicalDrive |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationPartition
Wenn Sie diesen Parameter verwenden, geben Sie -Destination SpecificDiskAndPartition
die Partitionsnummer an. Geben Sie eine ganze Zahl von 1
bis 99
. Verwenden Sie auch den DestinationDisk-Parameter.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DestinationVariable
Wenn Sie diesen Parameter verwenden, geben Sie -Destination LogicalDriverLetterInVariable
die Tasksequenzvariable mit dem logischen Laufwerkbuchstaben an. Der Variablenname muss alphanumerisch ohne Leerzeichen und weniger als 256 Zeichen sein.
Type: | String |
Aliases: | DestinationVariableName |
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 |
-ImagePackage
Geben Sie ein Betriebssystemimagepaketobjekt an. In diesem Schritt wird das Betriebssystem aus diesem Image angewendet. Verwenden Sie den ImagePackageIndex-Parameter, um den Bildindex festzulegen.
Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMOperatingSystemImage".
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImagePackageIndex
Geben Sie einen ganzzahligen Wert des Bildindex an. Verwenden Sie diesen Parameter mit dem ImagePackage-Parameter.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackage
Geben Sie ein Betriebssystemupgradepaketobjekt an. Der Schritt wendet das Betriebssystem aus dieser ursprünglichen Installationsquelle an. Verwenden Sie den Parameter InstallPackageIndex, um die Edition festzulegen.
Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMOperatingSystemInstaller".
Type: | IResultObject |
Aliases: | UpgradePackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallPackageIndex
Geben Sie einen ganzzahligen Wert der Edition des Betriebssystemupgradepakets an. Verwenden Sie diesen Parameter mit dem Parameter "InstallPackage".
Type: | Int32 |
Aliases: | UpgradePackageIndex |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LayeredDriver
Verwenden Sie ab Version 2107 diesen Parameter, um andere Arten von Tastaturen auszuwählen, die in japanischen und koreanischen Sprachen häufig verwendet werden. Geben Sie einen ganzzahligen Wert für den mehrstufigen Treiber an, der mit Windows installiert werden soll. Verwenden Sie dieselben Werte wie die OsdLayeredDriver-Tasksequenzvariable.
Type: | OsdLayeredDriver |
Aliases: | KeyboardDriver |
Accepted values: | DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6 |
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 |
-RunFromNet
Legen Sie diesen Parameter so $true
fest, dass die Tasksequenz das Betriebssystemimage direkt vom Verteilungspunkt aus anwenden kann.
Aus Gründen der Sicherheit wird empfohlen, diese Einstellung nicht zu aktivieren. Diese Option ist für die Verwendung auf Geräten mit begrenzter Speicherkapazität vorgesehen. Weitere Informationen finden Sie unter Zugreifen auf Inhalte direkt vom Verteilungspunkt aus.
Type: | Boolean |
Aliases: | AllowAccessFromDistributionPoint |
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_ApplyOperatingSystemAction Server-WMI-Klasse.