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 |
-CaptureLocallyUsingLink
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, XYZ00003
z. 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 WorkgroupType
festlegen, 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.