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.