Eseguire la console dell'app da riga di comando con il Toolkit di diagnostica per Surface per le aziende

• Si applica a:

  Windows 10, Windows 11

L'esecuzione di Surface Diagnostic Toolkit (SDT) al prompt dei comandi richiede il download della console dell'app SDT. Dopo l'installazione, è possibile eseguire SDT al prompt dei comandi tramite la console dei comandi di Windows (cmd.exe) o Windows PowerShell. Per un elenco dei dispositivi Surface supportati in SDT, vedere Distribuire Surface Diagnostic Toolkit for Business.

Nota

Per eseguire SDT usando i comandi, è necessario accedere all'account amministratore o accedere a un account membro del gruppo Administrator nel dispositivo Surface.

Esecuzione della console dell'app SDT

1. Scaricare e installare la console dell'app SDT dalla pagina di download di Surface Tools for IT.

• Per i dispositivi Intel/AMD, scaricare: Microsoft.Surface.Diagnostics.App.Console.v2.168.139.0.exe
• Per i dispositivi basati su ARM, scaricare: Microsoft.Surface.Diagnostics.App.Console.v2.168.139.0_x86.exe

2. Usare il prompt dei comandi di Windows (cmd.exe) o Windows PowerShell per:

• Raccogliere tutti i file di log
• Eseguire la diagnostica dell'integrità usando Best Practice Analyzer
• Controllare l'aggiornamento per gli aggiornamenti del firmware o del driver mancanti

Nota

In questa versione, la console dell'app SDT supporta solo comandi singoli. Per eseguire più opzioni della riga di comando è necessario eseguire l'exe della console separatamente per ogni comando.

Per impostazione predefinita, i file di output vengono salvati nello stesso percorso dell'app console. Per un elenco completo dei comandi, vedere la tabella seguente.

Comando	Note
-DataCollector "file di output"	Raccoglie i dettagli di sistema in un file ZIP. "file di output" è il percorso del file per creare il file ZIP dei dettagli di sistema. Esempio: Microsoft.Surface.Diagnostics.App.Console.exe -DataCollector SDT_DataCollection.zip
-bpa "file di output"	Controlla diverse impostazioni e indicatori di integrità nel dispositivo. "file di output" è il percorso del file per creare il report HTML. Esempio: Microsoft.Surface.Diagnostics.App.Console.exe -bpa BPA.html
-windowsupdate	Controlla Windows Update server online per verificare la presenza di aggiornamenti del firmware e/o del driver mancanti. Esempio: Microsoft.Surface.Diagnostics.App.Console.exe -windowsupdate
-warranty "file di output"	Controlla le informazioni sulla garanzia nel dispositivo (valide o non valide). Il "file di output" facoltativo è il percorso del file per creare il file xml. Esempio: Microsoft.Surface.Diagnostics.App.Console.exe -garanzia "warranty.xml"

Nota

Per eseguire la console dell'app SDT in remoto nei dispositivi di destinazione, è possibile usare uno strumento di gestione della configurazione, ad esempio Microsoft Endpoint Configuration Manager. In alternativa, è possibile creare un file .zip contenente l'app console e i comandi della console appropriati e distribuire in base ai processi di distribuzione software dell'organizzazione.

Esecuzione di Best Practice Analyzer

È possibile eseguire test BPA tra componenti chiave come BitLocker, Avvio protetto e TPM (Trusted Platform Module) e quindi restituire i risultati in un file condivisibile. Lo strumento genera una serie di tabelle con intestazioni codificate a colori e descrittori di condizione, oltre a indicazioni su come risolvere il problema.

• Verde indica che il componente è in esecuzione in una condizione ottimale (ottimale).
• Arancione indica che il componente non è in esecuzione in una condizione ottimale (non ottimale).
• Rosso indica che il componente si trova in uno stato anomalo.

Output dei risultati BPA di esempio

BitLocker

• Descrizione: verifica se BitLocker è abilitato nell'unità di sistema.
• Valore: Protezione attivata
• Condizione: ottimale
• Indicazioni: è consigliabile abilitare BitLocker per proteggere i dati.

Avvio protetto

• Descrizione: verifica se l'avvio protetto è abilitato.
• Valore: True
• Condizione: ottimale
• Indicazioni: è consigliabile abilitare l'avvio protetto per proteggere il PC.

Trusted Platform Module

• Descrizione: garantisce che il TPM sia funzionante.
• Valore: True
• Condizione: ottimale
• Indicazioni: senza un TPM funzionale, le funzioni basate sulla sicurezza, ad esempio BitLocker, potrebbero non funzionare correttamente.

Standby connesso

• Descrizione: controlla se Lo standby connesso è abilitato.
• Valore: True
• Condizione: ottimale
• Indicazioni: Lo standby connesso consente a un dispositivo Surface di ricevere aggiornamenti e notifiche mentre non viene usato. Per un'esperienza ottimale, è consigliabile abilitare Lo standby connesso.

Bluetooth

• Descrizione: controlla se Bluetooth è abilitato.
• Valore: abilitato
• Condizione: ottimale
• Indicazioni: N/D

Modalità di debug

• Descrizione: controlla se il sistema operativo è in modalità debug.
• Valore: Normale
• Condizione: ottimale
• Indicazioni: l'opzione di avvio del debug abilita o disabilita il debug del kernel del sistema operativo Windows. L'abilitazione di questa opzione può causare instabilità del sistema e impedire la riproduzione di supporti protetti da DRM (Digital Rights Management).

Firma di test

• Descrizione: verifica se la firma di test è abilitata.
• Valore: Normale
• Condizione: ottimale
• Indicazioni: La firma di test è un'impostazione di avvio di Windows che deve essere usata solo per testare i driver non aggiornati.

Combinazione per il risparmio di energia attiva

• Descrizione: verifica che la combinazione per il risparmio di energia corretta sia attiva.
• Valore: bilanciato
• Condizione: ottimale
• Indicazioni: è consigliabile usare la combinazione di alimentazione "bilanciata" per ottimizzare la produttività e la durata della batteria.

Windows Update

• Descrizione: controlla se il dispositivo è aggiornato con gli aggiornamenti di Windows.
• Valore: Microsoft Silverlight (KB4023307), Aggiornamento delle definizioni per Windows Defender Antivirus - KB2267602 (definizione 1.279.1433.0)
• Condizione: non ottimale
• Indicazioni: l'aggiornamento alle finestre più recenti assicura di avere il firmware e i driver più recenti.Guidance: Updating to the latest windows makes sure you are on the latest firmware and drivers. È consigliabile mantenere sempre aggiornato il dispositivo.

Spazio libero sul disco rigido

• Descrizione: verifica la disponibilità di spazio insufficiente sul disco rigido.
• Valore: 66%
• Condizione: ottimale
• Indicazioni: per ottenere prestazioni ottimali, il disco rigido deve avere almeno il 10% della capacità come spazio libero.

Dispositivi non funzionati

• Descrizione: elenco di dispositivi non funzionali in Gestione dispositivi.
• Valore: [Non specificato nello screenshot]
• Condizione: ottimale
• Indicazioni: i dispositivi non funzionali in Gestione dispositivi potrebbero causare problemi imprevisti con i dispositivi Surface, ad esempio, ma non solo, nessun risparmio di energia per il rispettivo componente hardware.

Monitoraggio esterno

• Descrizione: verifica la presenza di un monitoraggio esterno che potrebbe avere problemi di compatibilità.
• Valore: N/D
• Condizione: ottimale
• Indicazioni: verificare con il produttore dell'apparecchiatura originale la compatibilità con il dispositivo Surface.

Cronologia delle versioni

v2.218.139.0, data di rilascio: 24 ottobre 2023. Incluso in Surface IT Toolkit Library, 25 aprile 2024.