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 Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio i parametri del cmdlet vengono prima di tutto 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.

Type:Boolean
Aliases:CheckClientMinVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckMaxOSVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckMemory
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckMinOSVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckNetworkConnected

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

Type:Boolean
Aliases:NetworkConnected
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckNetworkWired

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

Type:Boolean
Aliases:NetworkWired
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckOSType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckOSArchitecture
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableOSLanguageId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckPowerState

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

Type:Boolean
Aliases:NotBattery
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckFreeDiskSpace
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:EnableCheckProcessorSpeed
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Boolean
Aliases:TpmActivated
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckTpmEnabled

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

Type:Boolean
Aliases:TpmEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckUefi

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:ClientMinVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Disable

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

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Aliases:MinimumFreeDiskSpace
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:CurrentMaxOSVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Aliases:MinimumMemory
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinOSVersion

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

Type:String
Aliases:CurrentMinOSVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:OSType
Aliases:CurrentOSType
Accepted values:Client, Server
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:OSArch
Aliases:CurrentOSArchitecture
Accepted values:Arch32, Arch64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Aliases:LanguageId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Aliases:MinimumProcessorSpeed
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.