New-CMTSStepPrestartCheck
Créez une étape Vérifier la préparation , que vous pouvez ajouter à une séquence de tâches.
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>]
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 Configuration Manager applets de commande à 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 |
Aliases: | CheckClientMinVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckMaxOSVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckMemory |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckMinOSVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckNetworkConnected
Définissez ce paramètre sur $true
pour activer la vérification connectée de la carte réseau .
Type: | Boolean |
Aliases: | NetworkConnected |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | NetworkWired |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckOSType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckOSArchitecture |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableOSLanguageId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckPowerState
Définissez ce paramètre sur $true
pour activer la vérification de l’alimentation secteur branchée .
Type: | Boolean |
Aliases: | NotBattery |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckFreeDiskSpace |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | EnableCheckProcessorSpeed |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | TpmActivated |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | TpmEnabled |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | ClientMinVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Spécifiez une description facultative pour cette étape de séquence de tâches.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Ajoutez ce paramètre pour désactiver cette étape de séquence de tâches.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | MinimumFreeDiskSpace |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | CurrentMaxOSVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | MinimumMemory |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | CurrentMinOSVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom pour cette étape afin de l’identifier dans la séquence de tâches.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | CurrentOSType |
Accepted values: | Client, Server |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | CurrentOSArchitecture |
Accepted values: | Arch32, Arch64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | LanguageId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | MinimumProcessorSpeed |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour