New-CMTSStepPrestartCheck
Créez une étape Vérifier la préparation , que vous pouvez ajouter à une séquence de tâches.
Syntaxe
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>]
Description
Cette applet de commande crée un nouvel objet d’étape Check Readiness . Utilisez ensuite l’applet de commande Add-CMTaskSequenceStep pour ajouter l’étape à une séquence de tâches. Pour plus d’informations sur cette étape, consultez À propos des étapes de séquence de tâches : Vérifier la préparation.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>
. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1
Cet exemple montre comment d’abordplate les paramètres de l’applet de commande dans la variable parameters .
Ensuite, il crée un objet pour l’étape Vérifier la préparation , en transmettant la collection de valeurs dans les paramètres.
Il obtient ensuite un objet de séquence de tâches et ajoute cette nouvelle étape à la séquence de tâches à l’index 11.
$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 11
Paramètres
-CheckCMClientMinVersion
Définissez ce paramètre sur $true
pour activer la vérification de la version minimale du client . Utilisez le paramètre CMClientMinVersion pour définir le numéro de version du client spécifique.
Type: | Boolean |
Alias: | CheckClientMinVersion |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckMaxOSVersion
Définissez ce paramètre sur $true
pour activer la vérification de la version maximale du système d’exploitation . Utilisez le paramètre MaxOSVersion pour définir le numéro de version du système d’exploitation spécifique.
Type: | Boolean |
Alias: | EnableCheckMaxOSVersion |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckMemory
Définissez ce paramètre sur $true
pour activer la vérification Mémoire minimale (Mo). Utilisez le paramètre Memory pour définir la taille de mémoire spécifique.
Type: | Boolean |
Alias: | EnableCheckMemory |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckMinOSVersion
Définissez ce paramètre sur $true
pour activer la vérification de la version minimale du système d’exploitation . Utilisez le paramètre MinOSVersion pour définir le numéro de version du système d’exploitation spécifique.
Type: | Boolean |
Alias: | EnableCheckMinOSVersion |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckNetworkConnected
Définissez ce paramètre sur $true
pour activer la vérification connectée de la carte réseau .
Type: | Boolean |
Alias: | NetworkConnected |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckNetworkWired
Définissez ce paramètre sur $true
pour activer la vérification de la carte réseau n’est pas sans fil .
Type: | Boolean |
Alias: | NetworkWired |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckOS
Définissez ce paramètre sur $true
pour activer la vérification du type de système d’exploitation, client ou serveur. Utilisez le paramètre SYSTÈME d’exploitation pour définir le type de système d’exploitation spécifique.
Type: | Boolean |
Alias: | EnableCheckOSType |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckOSArchitecture
Définissez ce paramètre sur $true
pour activer l’architecture de la vérification du système d’exploitation actuelle . Utilisez le paramètre OSArchitecture pour définir le type d’architecture spécifique.
Type: | Boolean |
Alias: | EnableCheckOSArchitecture |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckOSLanguageId
Définissez ce paramètre sur $true
pour activer la vérification de la langue du système d’exploitation actuel. Utilisez le paramètre OSLanguageID pour définir la langue spécifique.
Type: | Boolean |
Alias: | EnableOSLanguageId |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckPowerState
Définissez ce paramètre sur $true
pour activer la vérification de l’alimentation secteur branchée .
Type: | Boolean |
Alias: | NotBattery |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckSpace
Définissez ce paramètre sur $true
pour activer la vérification Espace disque disponible minimal (Mo). Utilisez le paramètre DiskSpace pour définir la taille spécifique.
Type: | Boolean |
Alias: | EnableCheckFreeDiskSpace |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckSpeed
Définissez ce paramètre sur $true
pour activer la vérification Vitesse minimale du processeur (MHz). Utilisez le paramètre Vitesse pour définir la vitesse spécifique.
Type: | Boolean |
Alias: | EnableCheckProcessorSpeed |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckTpmActivated
S’applique à la version 2111 et aux versions ultérieures. Définissez ce paramètre sur $true
pour activer la vérification TPM 2.0 ou ultérieure .
Type: | Boolean |
Alias: | TpmActivated |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckTpmEnabled
S’applique à la version 2111 et aux versions ultérieures. Définissez ce paramètre sur $true
pour activer la vérification TPM 2.0 ou ultérieure .
Type: | Boolean |
Alias: | TpmEnabled |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CheckUefi
S’applique à la version 2006 et ultérieure. Définissez ce paramètre sur $true
pour activer la vérification de l’ordinateur en mode UEFI .
Type: | Boolean |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CMClientMinVersion
Utilisez ce paramètre pour configurer la version du client spécifique. Spécifiez la version du client au format suivant : 5.00.8913.1005
. Utilisez le paramètre CheckCMClientMinVersion pour activer ou désactiver la vérification.
Type: | String |
Alias: | ClientMinVersion |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Condition
Spécifiez un objet de condition à utiliser avec cette étape. Pour obtenir cet objet, utilisez l’une des applets de commande de condition de séquence de tâches. Par exemple, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Alias: | Conditions |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ContinueOnError
Ajoutez ce paramètre pour activer l’option d’étape Continuer en cas d’erreur. Lorsque vous activez cette option, si l’étape échoue, la séquence de tâches continue.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Description
Spécifiez une description facultative pour cette étape de séquence de tâches.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Disable
Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.
Type: | SwitchParameter |
Alias: | DisableThisStep |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DiskSpace
Utilisez ce paramètre pour configurer la taille spécifique pour la vérification de l’espace disque disponible minimal. Spécifiez une valeur entière pour la taille en Mo. Utilisez le paramètre CheckSpace pour activer ou désactiver la vérification.
Type: | Int32 |
Alias: | MinimumFreeDiskSpace |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ForceWildcardHandling
Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-MaxOSVersion
Utilisez ce paramètre pour configurer la version du système d’exploitation spécifique. Spécifiez la version maximale du système d’exploitation avec la version principale, la version mineure et le numéro de build. Par exemple : 10.0.18356
. Utilisez le paramètre CheckMaxOSVersion pour activer ou désactiver la vérification.
Type: | String |
Alias: | CurrentMaxOSVersion |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Memory
Utilisez ce paramètre pour configurer la taille spécifique pour la vérification de mémoire minimale. Spécifiez une valeur entière pour la taille en Mo. Utilisez le paramètre CheckMemory pour activer ou désactiver la vérification.
Type: | Int32 |
Alias: | MinimumMemory |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-MinOSVersion
Utilisez ce paramètre pour configurer la version du système d’exploitation spécifique. Spécifiez la version minimale du système d’exploitation avec la version principale, la version mineure et le numéro de build. Par exemple : 10.0.16299
. Utilisez le paramètre CheckMinOSVersion pour activer ou désactiver la vérification.
Type: | String |
Alias: | CurrentMinOSVersion |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Name
Spécifiez un nom pour cette étape afin de l’identifier dans la séquence de tâches.
Type: | String |
Alias: | StepName |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-OS
Utilisez ce paramètre pour configurer le type de système d’exploitation spécifique : Client
ou Server
. Utilisez le paramètre CheckOS pour activer ou désactiver la vérification.
Type: | OSType |
Alias: | CurrentOSType |
Valeurs acceptées: | Client, Server |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-OSArchitecture
Utilisez ce paramètre pour configurer l’architecture du système d’exploitation spécifique : Arch32
pour 32 bits ou Arch64
pour 64 bits. Utilisez le paramètre CheckOSArchitecture pour activer ou désactiver la vérification.
Type: | OSArch |
Alias: | CurrentOSArchitecture |
Valeurs acceptées: | Arch32, Arch64 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-OSLanguageId
Utilisez ce paramètre pour configurer la langue du système d’exploitation spécifique. Cette vérification compare l’ID de langue à la propriété OSLanguage de la classe WMI Win32_OperatingSystem sur le client. Par exemple, 1033
pour l’anglais (États-Unis). Utilisez le paramètre CheckOSLanguageId pour activer ou désactiver la vérification.
Type: | Int32 |
Alias: | LanguageId |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Speed
Utilisez ce paramètre pour configurer la vitesse spécifique pour la vérification de la vitesse minimale du processeur. Spécifiez une valeur entière pour la vitesse en MHz. Utilisez le paramètre CheckSpeed pour activer ou désactiver la vérification.
Type: | Int32 |
Alias: | MinimumProcessorSpeed |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
None
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_PrestartCheckAction classe WMI du serveur.