New-CMTSStepPrestartCheck

Creare un passaggio Verifica idoneità , che è possibile aggiungere a una sequenza di attività.

Sintassi

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>]

Descrizione

Questo cmdlet crea un nuovo oggetto passaggio Check Readiness . Usare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per altre informazioni su questo passaggio, vedere Informazioni sui passaggi della sequenza di attività: Verifica idoneità.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio i parametri del cmdlet vengono innanzitutto inseriti nella variabile parameters .

Successivamente viene creato un oggetto per il passaggio Verifica idoneità , passando la raccolta di valori nei parametri.

Ottiene quindi un oggetto sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 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

Parametri

-CheckCMClientMinVersion

Impostare questo parametro su $true per abilitare il controllo della versione minima del client . Usare il parametro CMClientMinVersion per impostare il numero di versione del client specifico.

Tipo:Boolean
Alias:CheckClientMinVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckMaxOSVersion

Impostare questo parametro su $true per abilitare il controllo della versione massimo del sistema operativo . Usare il parametro MaxOSVersion per impostare il numero di versione del sistema operativo specifico.

Tipo:Boolean
Alias:EnableCheckMaxOSVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckMemory

Impostare questo parametro su $true per abilitare il controllo Memoria minima (MB). Usare il parametro Memoria per impostare le dimensioni specifiche della memoria.

Tipo:Boolean
Alias:EnableCheckMemory
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckMinOSVersion

Impostare questo parametro su $true per abilitare il controllo della versione minima del sistema operativo . Usare il parametro MinOSVersion per impostare il numero di versione del sistema operativo specifico.

Tipo:Boolean
Alias:EnableCheckMinOSVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckNetworkConnected

Impostare questo parametro su $true per abilitare il controllo connesso alla scheda di rete .

Tipo:Boolean
Alias:NetworkConnected
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckNetworkWired

Impostare questo parametro su $true per abilitare la scheda di rete non è un controllo wireless.

Tipo:Boolean
Alias:NetworkWired
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckOS

Impostare questo parametro su $true per abilitare il controllo del tipo di sistema operativo, client o server. Usare il sistema operativo del parametro per impostare il tipo di sistema operativo specifico.

Tipo:Boolean
Alias:EnableCheckOSType
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckOSArchitecture

Impostare questo parametro su $true per abilitare l'architettura del controllo del sistema operativo corrente . Usare il parametro OSArchitecture per impostare il tipo di architettura specifico.

Tipo:Boolean
Alias:EnableCheckOSArchitecture
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckOSLanguageId

Impostare questo parametro su $true per abilitare il controllo della lingua del sistema operativo corrente. Usare il parametro OSLanguageID per impostare la lingua specifica.

Tipo:Boolean
Alias:EnableOSLanguageId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckPowerState

Impostare questo parametro su $true per abilitare il controllo dell'alimentazione ac.

Tipo:Boolean
Alias:NotBattery
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckSpace

Impostare questo parametro su $true per abilitare il controllo Spazio disponibile minimo su disco (MB). Usare il parametro DiskSpace per impostare le dimensioni specifiche.

Tipo:Boolean
Alias:EnableCheckFreeDiskSpace
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckSpeed

Impostare questo parametro su $true per abilitare il controllo velocità minima del processore (MHz). Usare il parametro Speed per impostare la velocità specifica.

Tipo:Boolean
Alias:EnableCheckProcessorSpeed
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckTpmActivated

Si applica alla versione 2111 e successive. Impostare questo parametro su $true per abilitare il controllo attivato di TPM 2.0 o versione successiva .

Tipo:Boolean
Alias:TpmActivated
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckTpmEnabled

Si applica alla versione 2111 e successive. Impostare questo parametro su $true per abilitare il controllo TPM 2.0 o versione successiva .

Tipo:Boolean
Alias:TpmEnabled
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CheckUefi

Si applica alla versione 2006 e successive. Impostare questo parametro su $true per abilitare il controllo in modalità UEFI del computer .

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CMClientMinVersion

Usare questo parametro per configurare la versione client specifica. Specificare la versione client nel formato seguente: 5.00.8913.1005. Usare il parametro CheckCMClientMinVersion per abilitare o disabilitare il controllo.

Tipo:String
Alias:ClientMinVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Condition

Specificare un oggetto condizione da usare con questo passaggio. Per ottenere questo oggetto, usare uno dei cmdlet della condizione della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Alias:Conditions
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContinueOnError

Aggiungere questo parametro per abilitare l'opzione di passaggio Continua in caso di errore. Quando si abilita questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Disable

Aggiungere questo parametro per disabilitare questo passaggio della sequenza di attività.

Tipo:SwitchParameter
Alias:DisableThisStep
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DiskSpace

Usare questo parametro per configurare le dimensioni specifiche per il controllo dello spazio disponibile minimo su disco. Specificare un valore intero per le dimensioni in MB. Usare il parametro CheckSpace per abilitare o disabilitare il controllo.

Tipo:Int32
Alias:MinimumFreeDiskSpace
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxOSVersion

Usare questo parametro per configurare la versione specifica del sistema operativo. Specificare la versione massima del sistema operativo con versione principale, versione secondaria e numero di build. Ad esempio, 10.0.18356. Usare il parametro CheckMaxOSVersion per abilitare o disabilitare il controllo.

Tipo:String
Alias:CurrentMaxOSVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Memory

Usare questo parametro per configurare le dimensioni specifiche per il controllo minimo della memoria. Specificare un valore intero per le dimensioni in MB. Usare il parametro CheckMemory per abilitare o disabilitare il controllo.

Tipo:Int32
Alias:MinimumMemory
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinOSVersion

Usare questo parametro per configurare la versione specifica del sistema operativo. Specificare la versione minima del sistema operativo con versione principale, versione secondaria e numero di build. Ad esempio, 10.0.16299. Usare il parametro CheckMinOSVersion per abilitare o disabilitare il controllo.

Tipo:String
Alias:CurrentMinOSVersion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.

Tipo:String
Alias:StepName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OS

Usare questo parametro per configurare il tipo di sistema operativo specifico: Client o Server. Usare il parametro CheckOS per abilitare o disabilitare il controllo.

Tipo:OSType
Alias:CurrentOSType
Valori accettati:Client, Server
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OSArchitecture

Usare questo parametro per configurare l'architettura del sistema operativo specifica: Arch32 per 32 bit o Arch64 per 64 bit. Usare il parametro CheckOSArchitecture per abilitare o disabilitare il controllo.

Tipo:OSArch
Alias:CurrentOSArchitecture
Valori accettati:Arch32, Arch64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OSLanguageId

Usare questo parametro per configurare il linguaggio del sistema operativo specifico. Questo controllo confronta l'ID lingua con la proprietà OSLanguage della classe WMI Win32_OperatingSystem nel client. Ad esempio, 1033 per l'inglese (Stati Uniti). Usare il parametro CheckOSLanguageId per abilitare o disabilitare il controllo.

Tipo:Int32
Alias:LanguageId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Speed

Usare questo parametro per configurare la velocità specifica per il controllo della velocità minima del processore. Specificare un valore intero per la velocità in MHz. Usare il parametro CheckSpeed per abilitare o disabilitare il controllo.

Tipo:Int32
Alias:MinimumProcessorSpeed
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_PrestartCheckAction classe WMI del server.