New-CMTSStepPrestartCheck
Erstellen Sie einen Schritt Bereitschaft überprüfen , den Sie einer Tasksequenz hinzufügen können.
Syntax
New-CMTSStepPrestartCheck
[-CheckCMClientMinVersion <Boolean>]
[-CheckMaxOSVersion <Boolean>]
[-CheckMemory <Boolean>]
[-CheckMinOSVersion <Boolean>]
[-CheckNetworkConnected <Boolean>]
[-CheckNetworkWired <Boolean>]
[-CheckTpmEnabled <Boolean>]
[-CheckTpmActivated <Boolean>]
[-CheckOS <Boolean>]
[-CheckOSArchitecture <Boolean>]
[-CheckOSLanguageId <Boolean>]
[-CheckPowerState <Boolean>]
[-CheckSpace <Boolean>]
[-CheckSpeed <Boolean>]
[-CheckUefi <Boolean>]
[-CMClientMinVersion <String>]
[-DiskSpace <Int32>]
[-MaxOSVersion <String>]
[-Memory <Int32>]
[-MinOSVersion <String>]
[-OS <OSType>]
[-OSArchitecture <OSArch>]
[-OSLanguageId <Int32>]
[-Speed <Int32>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Dieses Cmdlet erstellt ein neues Check Readiness-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: Überprüfen der Bereitschaft.
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 werden die Cmdlet-Parameter zuerst in die Parametervariablesplatsiert.
Als Nächstes wird ein -Objekt für den Schritt Check Readiness erstellt, wobei die Auflistung von Werten in Parametern übergeben wird.
Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.
$parameters = @{
Name = "Check Readiness"
CheckMemory = $true
Memory = 4096
CheckSpeed = $true
Speed = 1024
CheckSpace = $true
DiskSpace = 512000
CheckOS = $true
OS = "Client"
CheckOSArchitecture = $true
OSArchitecture = "Arch64"
CheckMinOSVersion = $true
MinOSVersion = "10.0.16299"
CheckMaxOSVersion = $true
MaxOSVersion = "10.0.99999"
CheckCMClientMinVersion = $true
CMClientMinVersion = "5.00.8913.1005"
CheckOSLanguageId = $true
OSLanguageID = 1033
CheckPowerState = $true
CheckNetworkConnected = $true
CheckNetworkWired = $false
CheckUefi = $true
}
$step = New-CMTSStepPrestartCheck @parameters
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11Parameter
-CheckCMClientMinVersion
Legen Sie diesen Parameter auf fest $true , um die Überprüfung der Mindestclientversion zu aktivieren. Verwenden Sie den Parameter CMClientMinVersion , um die spezifische Clientversionsnummer festzulegen.
| Typ: | Boolean |
| Aliase: | CheckClientMinVersion |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckMaxOSVersion
Legen Sie diesen Parameter auf fest $true , um die Überprüfung der maximalen Betriebssystemversion zu aktivieren. Verwenden Sie den Parameter MaxOSVersion , um die spezifische Versionsnummer des Betriebssystems festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckMaxOSVersion |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckMemory
Legen Sie diesen Parameter auf fest $true , um die Überprüfung Minimaler Arbeitsspeicher (MB) zu aktivieren. Verwenden Sie den Parameter Memory , um die spezifische Speichergröße festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckMemory |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckMinOSVersion
Legen Sie diesen Parameter auf fest $true , um die Überprüfung der Mindestversion des Betriebssystems zu aktivieren. Verwenden Sie den Parameter MinOSVersion , um die spezifische Versionsnummer des Betriebssystems festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckMinOSVersion |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckNetworkConnected
Legen Sie diesen Parameter auf fest $true , um die Überprüfung Netzwerkadapter verbunden zu aktivieren.
| Typ: | Boolean |
| Aliase: | NetworkConnected |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckNetworkWired
Legen Sie diesen Parameter auf fest $true , um die Überprüfung des Netzwerkadapters ist nicht drahtlos zu aktivieren.
| Typ: | Boolean |
| Aliase: | NetworkWired |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckOS
Legen Sie diesen Parameter auf fest $true , um die Überprüfung auf den Typ des Betriebssystems zu aktivieren, entweder Client oder Server. Verwenden Sie den Parameter Betriebssystem , um den spezifischen Betriebssystemtyp festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckOSType |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckOSArchitecture
Legen Sie diesen Parameter auf fest $true , um die Überprüfung Architektur des aktuellen Betriebssystems zu aktivieren. Verwenden Sie den Parameter OSArchitecture , um den spezifischen Architekturtyp festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckOSArchitecture |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckOSLanguageId
Legen Sie diesen Parameter auf fest $true , um die Überprüfung der Sprache des aktuellen Betriebssystems zu aktivieren. Verwenden Sie den Parameter OSLanguageID , um die spezifische Sprache festzulegen.
| Typ: | Boolean |
| Aliase: | EnableOSLanguageId |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckPowerState
Legen Sie diesen Parameter auf fest $true , um das Netzkabel-Check zu aktivieren.
| Typ: | Boolean |
| Aliase: | NotBattery |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckSpace
Legen Sie diesen Parameter auf fest $true , um die Überprüfung Minimaler freier Speicherplatz (MB) zu aktivieren. Verwenden Sie den Parameter DiskSpace , um die spezifische Größe festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckFreeDiskSpace |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckSpeed
Legen Sie diesen Parameter auf fest $true , um die Überprüfung Minimale Prozessorgeschwindigkeit (MHz) zu aktivieren. Verwenden Sie den Parameter Speed , um die bestimmte Geschwindigkeit festzulegen.
| Typ: | Boolean |
| Aliase: | EnableCheckProcessorSpeed |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckTpmActivated
Gilt für Version 2111 und höher. Legen Sie diesen Parameter auf fest $true , um die Überprüfung tpm 2.0 oder höher ist aktiviert zu aktivieren.
| Typ: | Boolean |
| Aliase: | TpmActivated |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckTpmEnabled
Gilt für Version 2111 und höher. Legen Sie diesen Parameter auf fest $true , um die Überprüfung tpm 2.0 oder höher ist aktiviert zu aktivieren.
| Typ: | Boolean |
| Aliase: | TpmEnabled |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CheckUefi
Gilt für Version 2006 und höher. Legen Sie diesen Parameter auf fest $true , um die Überprüfung Computer befindet sich im UEFI-Modus zu aktivieren.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CMClientMinVersion
Verwenden Sie diesen Parameter, um die spezifische Clientversion zu konfigurieren. Geben Sie die Clientversion im folgenden Format an: 5.00.8913.1005. Verwenden Sie den Parameter CheckCMClientMinVersion , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | String |
| Aliase: | ClientMinVersion |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-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.
| Typ: | IResultObject[] |
| Aliase: | Conditions |
| 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: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContinueOnError
Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortsetzen zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Disable
Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.
| Typ: | SwitchParameter |
| Aliase: | DisableThisStep |
| 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 |
-DiskSpace
Verwenden Sie diesen Parameter, um die spezifische Größe für die Überprüfung des minimalen freien Speicherplatzes zu konfigurieren. Geben Sie einen ganzzahligen Wert für die Größe in MB an. Verwenden Sie den Parameter CheckSpace , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | Int32 |
| Aliase: | MinimumFreeDiskSpace |
| 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 |
-MaxOSVersion
Verwenden Sie diesen Parameter, um die spezifische Betriebssystemversion zu konfigurieren. Geben Sie die maximale Betriebssystemversion mit Hauptversion, Nebenversion und Buildnummer an. Beispiel: 10.0.18356. Verwenden Sie den CheckMaxOSVersion-Parameter , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | String |
| Aliase: | CurrentMaxOSVersion |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Memory
Verwenden Sie diesen Parameter, um die spezifische Größe für die Mindestspeicherüberprüfung zu konfigurieren. Geben Sie einen ganzzahligen Wert für die Größe in MB an. Verwenden Sie den Parameter CheckMemory , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | Int32 |
| Aliase: | MinimumMemory |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MinOSVersion
Verwenden Sie diesen Parameter, um die spezifische Betriebssystemversion zu konfigurieren. Geben Sie die Mindestversion des Betriebssystems mit Hauptversion, Nebenversion und Buildnummer an. Beispiel: 10.0.16299. Verwenden Sie den Parameter CheckMinOSVersion , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | String |
| Aliase: | CurrentMinOSVersion |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.
| Typ: | String |
| Aliase: | StepName |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OS
Verwenden Sie diesen Parameter, um den spezifischen Betriebssystemtyp zu konfigurieren: Client oder Server. Verwenden Sie den CheckOS-Parameter , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | OSType |
| Aliase: | CurrentOSType |
| Zulässige Werte: | Client, Server |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OSArchitecture
Verwenden Sie diesen Parameter, um die spezifische Betriebssystemarchitektur zu konfigurieren: Arch32 für 32-Bit oder Arch64 für 64-Bit. Verwenden Sie den Parameter CheckOSArchitecture , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | OSArch |
| Aliase: | CurrentOSArchitecture |
| Zulässige Werte: | Arch32, Arch64 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OSLanguageId
Verwenden Sie diesen Parameter, um die spezifische Betriebssystemsprache zu konfigurieren. Bei dieser Überprüfung wird die Sprach-ID mit der OSLanguage-Eigenschaft der Win32_OperatingSystem WMI-Klasse auf dem Client verglichen. Beispiel 1033 : Für Englisch (USA). Verwenden Sie den Parameter CheckOSLanguageId , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | Int32 |
| Aliase: | LanguageId |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Speed
Verwenden Sie diesen Parameter, um die spezifische Geschwindigkeit für die Überprüfung der Minimalprozessorgeschwindigkeit zu konfigurieren. Geben Sie einen ganzzahligen Wert für die Geschwindigkeit in MHz an. Verwenden Sie den Parameter CheckSpeed , um die Überprüfung zu aktivieren oder zu deaktivieren.
| Typ: | Int32 |
| Aliase: | MinimumProcessorSpeed |
| 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: | 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_TaskSequence_PrestartCheckAction WMI-Serverklasse.