Freigeben über


New-CMTaskSequence

Erstellen Sie eine Tasksequenz.

Syntax

New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-BuildOperatingSystemImage]
   [-ClientPackagePackageId <String>]
   [-CreatedBy <String>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-ImageDescription <String>]
   [-ImageVersion <String>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   [-MaximumServerConnection <Int32>]
   -Name <String>
   -OperatingSystemFileAccount <String>
   [-OperatingSystemFileAccountPassword <SecureString>]
   -OperatingSystemFilePath <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-ApplyAll <Boolean>]
   -BootImagePackageId <String>
   [-CaptureLocallyUsingLink <Boolean>]
   [-CaptureNetworkSetting <Boolean>]
   [-CaptureUserSetting <Boolean>]
   [-CaptureWindowsSetting <Boolean>]
   [-ClientPackagePackageId <String>]
   [-ConfigureBitLocker <Boolean>]
   [-Description <String>]
   [-DomainAccount <String>]
   [-DomainName <String>]
   [-DomainOrganizationUnit <String>]
   [-DomainPassword <SecureString>]
   [-GeneratePassword <Boolean>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   [-InstallationLicensingMode <ServerLicensingMode>]
   [-InstallationProperty <String>]
   [-InstallOperatingSystemImage]
   -JoinDomain <JoinType>
   [-LocalAdminPassword <SecureString>]
   -Name <String>
   -OperatingSystemImageIndex <UInt32>
   -OperatingSystemImagePackageId <String>
   [-PartitionAndFormatTarget <Boolean>]
   [-ProductKey <String>]
   [-SaveLocally <Boolean>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-TimeZone <TimeZoneInfo>]
   [-UserStateMigrationToolPackageId <String>]
   [-WorkgroupName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-ApplicationName <String[]>]
   [-HighPerformance <Boolean>]
   [-IgnoreInvalidApplication <Boolean>]
   -Name <String>
   [-ProductKey <String>]
   [-SoftwareUpdateStyle <SoftwareUpdateStyleType>]
   [-UpgradeOperatingSystem]
   -UpgradePackageId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequence
   [-BootImagePackageId <String>]
   [-CustomTaskSequence]
   [-Description <String>]
   [-HighPerformance <Boolean>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Tasksequenz zu erstellen. Sie verwenden in der Regel eine Tasksequenz, um ein Betriebssystem auf einem Client bereitzustellen, aber Sie können sie für verschiedene Zwecke verwenden. Weitere Informationen finden Sie unter Verwalten von Tasksequenzen zum Automatisieren von Aufgaben.

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: Erstellen einer benutzerdefinierten Tasksequenz

In diesem Beispiel werden die Cmdlet-Parameter zuerst in die Parametervariablesplatsiert. Es ist nicht erforderlich, die Parameter zu splatieren, es erleichtert nur das Lesen der Parameter für eine so lange Befehlszeile.

Dieser Befehl erstellt eine leere Tasksequenz mit dem Namen Benutzerdefiniert.

$parameters = @{
  CustomTaskSequence = $true
  Name = "Custom"
  Description = "NewCustom parameter set"
  HighPerformance = $false
  BootImagePackageId = "XYZ00002"
}

New-CMTaskSequence @parameters

Beispiel 2: Erstellen einer Tasksequenz zum Installieren eines Betriebssystemimages

In diesem Beispiel werden die Cmdlet-Parameter zuerst in die Parametervariablesplatsiert. Es ist nicht erforderlich, die Parameter zu splatieren, es erleichtert nur das Lesen der Parameter für eine so lange Befehlszeile.

Dieser Befehl erstellt eine Tasksequenz mit dem Namen Betriebssystemimage installieren , die ein Betriebssystemimage installiert. Es enthält auch die anderen Parameter, die für dieses Szenario gelten.

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  InstallOperatingSystemImage = $true
  Name = "Install OS image"
  Description = "NewInstallOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  CaptureNetworkSetting = $true
  CaptureUserSetting = $true
  SaveLocally = $true
  CaptureLocallyUsingLink = $true
  UserStateMigrationToolPackageId = "XYZ00001"
  CaptureWindowsSetting = $true
  ConfigureBitLocker = $true
  PartitionAndFormatTarget = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "DomainType"
  DomainAccount = "contoso\jqpublic"
  DomainName = "contoso"
  DomainOrganizationUnit = "LDAP://OU=Workstations,OU=Devices,DC=na,DC=contoso,DC=com"
  DomainPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $false
  SoftwareUpdateStyle = "All"
}

New-CMTaskSequence @parameters

Beispiel 3: Erstellen einer Tasksequenz zum Erstellen und Erfassen eines Betriebssystems

In diesem Beispiel werden die Cmdlet-Parameter zuerst in die Parametervariablesplatsiert. Es ist nicht erforderlich, die Parameter zu splatieren, es erleichtert nur das Lesen der Parameter für eine so lange Befehlszeile.

In diesem Beispiel wird eine Tasksequenz mit dem Namen Build and capture erstellt, die ein Betriebssystemimage unter Verwendung des angegebenen Speicherorts und Kontos erstellt und erfasst. Es enthält auch die anderen Parameter, die für dieses Szenario gelten.

$clientProps = '/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSMP=mp01.contoso.com'

$parameters = @{
  BuildOperatingSystemImage = $true
  Name = "Build and capture"
  Description = "NewBuildOSImage parameter set"
  BootImagePackageId = "XYZ00002"
  HighPerformance = $true
  ApplyAll = $false
  OperatingSystemImagePackageId = "XYZ001A0"
  OperatingSystemImageIndex = 1
  ProductKey = "6NMRW-2C8FM-D24W7-TQWMY-CWH2D"
  GeneratePassword = $true
  TimeZone = Get-TimeZone -Name "Eastern Standard Time"
  JoinDomain = "WorkgroupType"
  WorkgroupName = "groupwork"
  ClientPackagePackageId = "XYZ00003"
  InstallationProperty = $clientProps
  ApplicationName = "Admin Console"
  IgnoreInvalidApplication = $true
  SoftwareUpdateStyle = "All"
  OperatingSystemFilePath = "\\server1\images\capture.wim"
  ImageDescription = "image description"
  ImageVersion = "image version 1"
  CreatedBy = "jqpublic"
  OperatingSystemFileAccount = "contoso\jqpublic" 
  OperatingSystemFileAccountPassword = ConvertTo-SecureString -String "w%1H6EoxjQ&70^W" -AsPlainText -Force
}

New-CMTaskSequence @parameters

Beispiel 4: Erstellen einer Tasksequenz zum Aktualisieren eines Betriebssystems

Dieser Befehl erstellt die Tasksequenz mit dem Namen Direktes Upgrade und gibt an, dass das Betriebssystem mithilfe des Upgradepakets mit der ID XYZ02EBA aktualisiert wird.

New-CMTaskSequence -UpgradeOperatingSystem -Name "In-place upgrade" -UpgradePackageId "XYZ02EBA" -SoftwareUpdateStyle All

Parameter

-ApplicationName

Geben Sie ein Array von Anwendungsnamen an, die während der Tasksequenz installiert werden sollen. Dieser Parameter konfiguriert den Tasksequenzschritt Anwendung installieren .

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplyAll

Im Build- und Erfassungsszenario bestimmt der Zustand dieses Parameters die folgenden Verhaltensweisen:

  • $true: Die Tasksequenz formatiert den Datenträger nicht & partitionieren, bevor das Betriebssystemimage angewendet wird.

  • $false: Die Tasksequenz enthält die Schritte Datenträger formatieren und partitionieren , bevor das Betriebssystemimage angewendet wird.

Typ:Boolean
Aliase:ApplyAllImages
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BootImagePackageId

Geben Sie die ID eines Startabbildpakets an, das mit einer Tasksequenz verwendet werden soll, die ein Betriebssystem bereitstellt. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00005. .

Dieser Parameter konfiguriert die Tasksequenzeigenschaften.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-BuildOperatingSystemImage

Fügen Sie diesen Parameter hinzu, um eine Tasksequenz für das Build- und Erfassungsszenario zu erstellen. Weitere Informationen finden Sie unter Erstellen einer Tasksequenz zum Erfassen eines Betriebssystems.

Typ:SwitchParameter
Aliase:BuildOperatingSystemImageOption
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Wenn Sie den SaveLocally-Parameter aktivieren, um Benutzereinstellungen und Dateien lokal zu speichern, legen Sie diesen Parameter auf $true fest, um lokal zu erfassen, indem Sie Links anstelle von Dateien kopieren. Die Links, die Configuration Manager zum lokalen Speichern des Benutzerzustands verwendet, werden als feste Links bezeichnet.

Das Cmdlet ignoriert diesen Parameter, wenn SaveLocally$false ist.

Mit diesem Parameter wird der Schritt Benutzerstatus erfassen konfiguriert.

Typ:Boolean
Aliase:CaptureLocallyUsingLinks
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CaptureNetworkSetting

Legen Sie diesen Parameter auf $true fest, damit die Tasksequenz Netzwerkeinstellungen erfassen kann. Wenn Sie diese Option aktivieren, enthält die Tasksequenz den Schritt Netzwerkeinstellungen erfassen .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CaptureUserSetting

Legen Sie diesen Parameter auf $true fest, damit die Tasksequenz Benutzereinstellungen und -dateien erfassen kann. Wenn Sie diese Option aktivieren, enthält die Tasksequenz den Schritt Benutzerstatus erfassen . Verwenden Sie auch den Parameter UserStateMigrationToolPackageId .

Verwenden Sie SaveLocally und CaptureLocallyUsingLink , um zu konfigurieren, wo die Tasksequenz den Benutzerzustand speichert.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CaptureWindowsSetting

Legen Sie diesen Parameter auf $true fest, damit die Tasksequenz Windows-Einstellungen erfassen kann. Wenn Sie diese Option aktivieren, enthält die Tasksequenz den Schritt Windows-Einstellungen erfassen .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClientPackagePackageId

Geben Sie die ID des Clientpakets an, das installiert werden soll, wenn die Tasksequenz ausgeführt wird. Dieser Wert ist eine Standardpaket-ID, XYZ00003z. B. . Standortzuweisung und Clientkonfiguration erfolgen automatisch. Sie können zusätzliche Installationsparameter mit dem Parameter InstallationProperty angeben.

Dieser Parameter konfiguriert den Tasksequenzschritt Windows und ConfigMgr einrichten .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConfigureBitLocker

Legen Sie diesen Parameter auf $true fest, um die Tasksequenz für die Verwendung mit BitLocker zu konfigurieren. Wenn Sie diese Option aktivieren, umfasst die Tasksequenz die folgenden Schritte:

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CreatedBy

Geben Sie für das Build- und Erfassungsszenario eine optionale Zeichenfolge an, die sich in der erfassten Imagedatei für den Benutzer befindet, der sie erstellt hat. Die maximale Länge ist 255 Zeichen.

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage erfassen .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomTaskSequence

Fügen Sie diesen Parameter hinzu, um eine benutzerdefinierte Tasksequenz zu erstellen, die keine Schritte enthält. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten Tasksequenz.

Anschließend können Sie die 35 New-CMTSStep-Cmdlets verwenden, um der benutzerdefinierten Tasksequenz Schritte hinzuzufügen. Weitere Informationen finden Sie unter Informationen zu Tasksequenzschritten. In jedem Abschnitt werden die Tasksequenzschritte mit Links zu den zugeordneten Cmdlets beschrieben.

Typ:SwitchParameter
Aliase:CustomOption
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Geben Sie eine optionale Beschreibung für die Tasksequenz an. Die maximale Länge beträgt 512 Zeichen. Dieser Parameter konfiguriert die Tasksequenzeigenschaften.

Typ:String
Aliase:TaskSequenceDescription
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainAccount

Geben Sie ein Konto an, das über die erforderlichen Berechtigungen zum Hinzufügen des Computers in die Domäne verfügt. Verwenden Sie das folgende Format: Domain\User. Weitere Informationen finden Sie unter Ask sequence domain join account(Ask sequence domain join account).

Verwenden Sie den Parameter DomainName , um den Domänennamen anzugeben, und DomainPassword , um das Kennwort dieses Kontos anzugeben.

Dieser Parameter konfiguriert den Tasksequenzschritt Netzwerkeinstellungen anwenden .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainName

Geben Sie den Namen einer Domäne an, in die der Computer eingebunden werden soll, wenn die Tasksequenz ausgeführt wird. Dieser Parameter konfiguriert den Tasksequenzschritt Netzwerkeinstellungen anwenden .

Verwenden Sie den Parameter DomainAccount , um ein Konto anzugeben, das über Berechtigungen zum Beitreten zu dieser Domäne verfügt. Sie können auch den Parameter DomainOrganizationUnit verwenden, um eine Organisationseinheit anzugeben, in der das Computerkonto erstellt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainOrganizationUnit

Geben Sie eine Domänenorganisationseinheit (OE) an, in der das Computerkonto in der Domäne erstellt werden soll. Das Format dieses Werts ist der LDAP-Pfad (Lightweight Directory Access Protocol), z. B.: LDAP//OU=OSD staging,DC=contoso,DC=com. Geben Sie eine Organisationseinheit in der Domäne an, die Sie im Parameter DomainName angegeben haben.

Wenn sich ein vorhandenes Computerkonto bereits in einer Organisationseinheit befindet, lässt Active Directory das Ändern der Organisationseinheit nicht zu, und diese Einstellung wird ignoriert.

Dieser Parameter konfiguriert den Tasksequenzschritt Netzwerkeinstellungen anwenden .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DomainPassword

Geben Sie eine sichere Zeichenfolge für das Kennwort des Kontos an, das Sie mit dem Parameter DomainAccount angegeben haben.

Dieser Parameter konfiguriert den Tasksequenzschritt Netzwerkeinstellungen anwenden .

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GeneratePassword

Legen Sie diesen Parameter auf $true fest, um nach dem Zufallsprinzip das lokale Administratorkennwort zu generieren und das Konto zu deaktivieren. Diese Konfiguration wird empfohlen.

Dieser Parameter konfiguriert den Tasksequenzschritt Windows-Einstellungen anwenden .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HighPerformance

Legen Sie diesen Parameter auf $true fest, um die Tasksequenzoption als Hochleistungs-Energiesparplan auszuführen. Dieser Parameter konfiguriert die Tasksequenzeigenschaften. Weitere Informationen finden Sie unter Leistungsverbesserungen für Energiesparpläne.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IgnoreInvalidApplication

Wenn Sie diesen Parameter auf $true festlegen, setzt die Tasksequenz die Installation von Anwendungen in der Liste fort, wenn eine Anwendungsinstallation fehlschlägt. Verwenden Sie diesen Parameter mit dem ApplicationName-Parameter .

Dieser Parameter konfiguriert den Tasksequenzschritt Anwendung installieren .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImageDescription

Geben Sie für das Build- und Erfassungsszenario eine optionale Zeichenfolge an, die die erfasste Bilddatei beschreibt. Die maximale Länge ist 255 Zeichen.

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage erfassen .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ImageVersion

Geben Sie für das Build- und Erfassungsszenario eine optionale Zeichenfolge als Version der erfassten Imagedatei an. Sie definieren diesen Wert, es muss nicht die Betriebssystemversion sein. Die maximale Länge beträgt 32 Zeichen.

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage erfassen .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallationLicensingMode

Diese Einstellung gilt nur für Ältere Versionen von Windows, die nicht mehr unterstützt werden. Ab Version 2010 ist die Einstellung im Tasksequenz-Editor nicht mehr sichtbar. Vorhandene Tasksequenzen, die diese Einstellung weiterhin verwenden, funktionieren weiterhin unverändert.

Typ:ServerLicensingMode
Zulässige Werte:NonSpecify, PerSeat, PerServer
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallationProperty

Geben Sie alle zusätzlichen Installationseigenschaften an, die verwendet werden sollen, wenn die Tasksequenz den Configuration Manager-Client installiert. Die Standortzuweisung und die Standardkonfiguration werden automatisch von der Tasksequenz angegeben. Um mehrere Installationseigenschaften einzugeben, trennen Sie diese durch ein Leerzeichen. Wenn eine Eigenschaft Leerzeichen enthält, umschließen Sie sie in Anführungszeichen ("). Weitere Informationen finden Sie unter Informationen zu Clientinstallationsparametern und -eigenschaften in Configuration Manager.

Diese Liste darf SMSSITECODE nicht enthalten.

Dieser Parameter konfiguriert den Tasksequenzschritt Windows und ConfigMgr einrichten .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstallOperatingSystemImage

Fügen Sie diesen Parameter hinzu, um eine Tasksequenz für das Szenario zum Installieren des Betriebssystemimages zu erstellen. Weitere Informationen finden Sie unter Erstellen einer Tasksequenz zum Installieren eines Betriebssystems.

Typ:SwitchParameter
Aliase:InstallOperatingSystemImageOption
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JoinDomain

Verwenden Sie diesen Parameter, um den Tasksequenzschritt Netzwerkeinstellungen anwenden zu konfigurieren. Der Computer muss entweder einer Arbeitsgruppe oder einer Domäne beitreten.

  • DomainType: Treten Sie einer Domäne bei. Geben Sie außerdem DomainName, DomainAccount und DomainPassword an. Sie können auch DomainOrganizationUnit verwenden.

  • WorkgroupType: Beitreten zu einer Arbeitsgruppe. Geben Sie außerdem WorkgroupName an. Verwenden Sie diesen Wert mit dem Parameter BuildOperatingSystemImage . Im Build- und Erfassungsszenario tritt die Tasksequenz immer einer Arbeitsgruppe bei, bevor sie das Image erfasst.

Typ:JoinType
Zulässige Werte:DomainType, WorkgroupType
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LocalAdminPassword

Wenn Sie nicht die empfohlene Option für GeneratePassword verwenden, verwenden Sie diesen Parameter, um eine sichere Zeichenfolge als lokales Administratorkennwort anzugeben.

Dieser Parameter konfiguriert den Tasksequenzschritt Windows-Einstellungen anwenden .

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaximumServerConnection

Diese Einstellung gilt nur für Ältere Versionen von Windows, die nicht mehr unterstützt werden. Ab Version 2010 ist die Einstellung im Tasksequenz-Editor nicht mehr sichtbar. Vorhandene Tasksequenzen, die diese Einstellung weiterhin verwenden, funktionieren weiterhin unverändert.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie einen Namen für die Tasksequenz an. Die maximale Länge beträgt 50 Zeichen. Dieser Parameter konfiguriert die Tasksequenzeigenschaften.

Typ:String
Aliase:TaskSequenceName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OperatingSystemFileAccount

Geben Sie für das Build- und Erfassungsszenario den Namen eines Domänenkontos an, das über Berechtigungen für die Netzwerkfreigabe verfügt, die Sie im Parameter OperatingSystemFilePath angeben. Verwenden Sie OperatingSystemFileAccountPassword , um das Kontokennwort festzulegen.

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage erfassen .

Typ:String
Aliase:CaptureOperatingSystemFileAccount
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OperatingSystemFileAccountPassword

Geben Sie für das Build- und Erfassungsszenario eine sichere Zeichenfolge für das Kennwort des OperatingSystemFileAccount an.

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage erfassen .

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OperatingSystemFilePath

Geben Sie für das Build- und Erfassungsszenario den Dateipfad zu dem Netzwerkspeicherort an, den Configuration Manager zum Speichern des erfassten Betriebssystemimages verwendet. Der Pfad enthält den Dateinamen mit einer .wim Dateierweiterung. Verwenden Sie OperatingSystemFileAccount und OperatingSystemFileAccountPassword , um ein Konto anzugeben, das Zugriff auf diesen Speicherort hat.

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage erfassen .

Typ:String
Aliase:CaptureOperatingSystemFilePath
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OperatingSystemImageIndex

Geben Sie den Index des zu installierenden Betriebssystemimages für den Tasksequenzschritt Betriebssystemimage anwenden an.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OperatingSystemImagePackageId

Geben Sie die ID des zu installierenden Betriebssystemimagepakets an. Verwenden Sie OperatingSystemImageIndex , um den Imageindex anzugeben. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00050. .

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystemimage anwenden .

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartitionAndFormatTarget

Legen Sie diesen Parameter auf $true fest, damit die Tasksequenz den Zielcomputer partitionieren und formatieren kann, bevor das Betriebssystem installiert wird.

Dieser Parameter konfiguriert den Tasksequenzschritt Datenträger formatieren und partitionieren .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProductKey

Geben Sie den Windows-Product Key für die Betriebssysteminstallation an.

Dieser Parameter konfiguriert den Tasksequenzschritt Windows-Einstellungen anwenden .

Typ:String
Aliase:InstallationProductKey
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SaveLocally

Wenn Sie den CaptureUserSetting-Parameter aktivieren, verwenden Sie diesen Parameter, um zu bestimmen, wo die Tasksequenz den erfassten Benutzerzustand speichert:

  • $true: Die Tasksequenz konfiguriert den lokalen Zustandsspeicherort und erfasst lokal, indem Links verwendet werden, anstatt Dateien zu kopieren. Mit diesem Wert wird der Schritt Benutzerstatus erfassen konfiguriert.

    • Verwenden Sie den CaptureLocallyUsingLink-Parameter , um die Verwendung von hard-links zu konfigurieren.
  • $false: Die Tasksequenz enthält Schritte zur Verwendung eines Zustandsmigrationspunkts. Es werden die folgenden Schritte konfiguriert:

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftwareUpdateStyle

Geben Sie an, ob Softwareupdates während der Tasksequenz installiert werden sollen. Die Werte bestimmen den Typ der Softwareupdatebereitstellung:

  • All: Zur Installation verfügbar, alle Softwareupdates
  • Mandatory: Erforderlich für die Installation, nur obligatorische Softwareupdates
  • NoInstall: Installieren Sie keine Softwareupdates.

Dieser Parameter konfiguriert den Tasksequenzschritt Softwareupdates installieren .

Typ:SoftwareUpdateStyleType
Zulässige Werte:All, Mandatory, NoInstall
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeZone

Geben Sie die Standardzeitzone für diese Installation von Windows an. Verwenden Sie zum Abrufen eines Zeitzonenobjekts das integrierte Cmdlet Get-TimeZone .

Dieser Parameter konfiguriert den Tasksequenzschritt Windows-Einstellungen anwenden .

Typ:TimeZoneInfo
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpgradeOperatingSystem

Fügen Sie diesen Parameter hinzu, um eine Tasksequenz für das Betriebssystemupgradeszenario zu erstellen. Weitere Informationen finden Sie unter Erstellen einer Tasksequenz zum Aktualisieren eines Betriebssystems.

Typ:SwitchParameter
Aliase:UpgradeOperatingSystemOption
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UpgradePackageId

Geben Sie die ID des zu verwendenden Betriebssystemupgradepakets an. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00052. .

Dieser Parameter konfiguriert den Tasksequenzschritt Betriebssystem aktualisieren .

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserStateMigrationToolPackageId

Wenn Sie CaptureUserSetting auf $true festlegen, verwenden Sie diesen Parameter, um die ID des USMT-Pakets (User State Migration Tool) anzugeben. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00012. .

Dieser Parameter konfiguriert die Schritte Benutzerstatus erfassen und Benutzerstatus wiederherstellen .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
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:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WorkgroupName

Wenn Sie den JoinDomain-Parameter auf WorkgroupTypefestlegen, verwenden Sie diesen Parameter, um den Arbeitsgruppennamen anzugeben. Dieser Parameter konfiguriert den Tasksequenzschritt Netzwerkeinstellungen anwenden .

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequencePackage WMI-Serverklasse.

Im Tasksequenzschritt Windows-Einstellungen anwenden legt dieses Cmdlet den Wert Benutzername auf den Benutzer fest, der das Cmdlet ausführt, und organisationsname auf den Computernamen, auf dem das Cmdlet ausgeführt wird.

Sie können nicht alle Tasksequenz- und Schritteinstellungen mit diesem Cmdlet konfigurieren. Verwenden Sie zum Konfigurieren anderer Einstellungen Set-CMTaskSequence und die Cmdlets Set-CMTSStep , z. B. Set-CMTSStepApplyOperatingSystem.