Dell Command | Warranty
Guida dell'utente
Giugno 2021
Rev. A01
Messaggi di N.B., Attenzione e Avvertenza
N.B.: un messaggio N.B. (Nota Bene) indica informazioni importanti che contribuiscono a migliorare l'utilizzo del prodotto.
ATTENZIONE: un messaggio di ATTENZIONE evidenzia la possibilità che si verifichi un danno all'hardware o una perdita di dati ed indica come evitare il problema.
AVVERTENZA: un messaggio di AVVERTENZA evidenzia un potenziale rischio di danni alla proprietà, lesioni personali o morte.
© 2021 Dell Inc. o sue società controllate. Tutti i diritti riservati. Dell, EMC e altri marchi sono marchi commerciali di Dell Inc. o di sue società controllate. Altri marchi possono essere marchi dei rispettivi proprietari.
Sommario
Capitolo 1: Dell Command | Warranty................................................................................................4
Sistemi operativi client supportati....................................................................................................................................... 4
Sistemi operativi server supportati......................................................................................................................................4
Capitolo 2: Installazione di Dell Command | Warranty.........................................................................5
Installazione di Dell Command | Warranty come parte di Dell Command | Integration Suite for System Center.....5
Installazione di Dell Command | Warranty come applicazione standalone..................................................................... 5
Capitolo 3: Avviare Dell Command | Warranty....................................................................................6
Capitolo 4: Configurazione di Dell Command | Warranty..................................................................... 7
Capitolo 5: Recupero delle informazioni Warranty..............................................................................8
Appendice A: Opzioni dell'interfaccia della riga di comando (CLI)........................................................9
Appendice B: Schema del database di output Warranty.....................................................................12
Sommario 3
1
Dell Command | Warranty
Dell Command | Warranty può essere installato come applicazione standalone o come parte di Dell Command | Integration Suite for
System Center sui sistemi con Microsoft System Center 2012 Configuration Manager, System Center 2012 SP1 Configuration Manager,
System Center 2012 R2 Configuration Manager e Microsoft System Center Current Branch. Dell Command | Warranty consente di recuperare le informazioni sulla garanzia per un elenco di sistemi client memorizzati nel database di Configuration Manager o in un file. I sistemi client sono specificati tramite i relativi codici di matricola.
Argomenti:
•
Sistemi operativi client supportati
•
Sistemi operativi server supportati
Sistemi operativi client supportati
● Windows 10 a 32 bit
● Windows 10 a 64 bit
● Windows 10 Professional a 32 bit
● Windows 10 Professional a 64 bit
● Windows 10 Enterprise a 32 bit
● Windows 10 Enterprise a 64 bit
● Windows 8.1 a 32 bit
● Windows 8.1 a 64 bit
● Windows 8.1 Professional a 32 bit
● Windows 8.1 Professional a 64 bit
● Windows 8.1 Enterprise a 32 bit
● Windows 8.1 Enterprise a 64 bit
● Windows 8 a 32 bit
● Windows 8 a 64 bit
● Windows 8 Professional a 32 bit
● Windows 8 Professional a 64 bit
● Windows 7 Professional a 32 bit
● Windows 7 Professional a 64 bit
● Windows 7 Ultimate a 32 bit
● Windows 7 Ultimate a 64 bit
Sistemi operativi server supportati
● Windows Server 2019
● Windows Server 2016
● Windows Server 2012 R2
● Windows Server 2012
4 Dell Command | Warranty
2
Installazione di Dell Command | Warranty
Dell Command | Warranty può essere installato come applicazione standalone o come parte di Dell Command | Integration Suite for
System Center sui sistemi con Microsoft System Center 2012 Configuration Manager.
N.B.: Per installare Dell Command | Warranty, è necessario aver effettuato l'accesso come amministratori di sistema.
Argomenti:
•
Installazione di Dell Command | Warranty come parte di Dell Command | Integration Suite for System Center
•
Installazione di Dell Command | Warranty come applicazione standalone
Installazione di Dell Command | Warranty come parte di
Dell Command | Integration Suite for System Center
1. Scaricare e salvare il file Dell Command | Integration Suite for System Center .exe nel sistema utilizzato per la gestione dei client.
2. Fare clic sul file *.exe, quindi su Avanti nella schermata iniziale.
3. Accettare il contratto di licenza Microsoft, quindi fare clic su Avanti .
4. Selezionare l'opzione di installazione Completa , quindi fare clic su Avanti .
5. Seguire la parte restante della procedura guidata di installazione.
6. Al termine del processo di installazione, fare clic su Fine .
Installazione di Dell Command | Warranty come applicazione standalone
1. Scaricare e salvare il file Dell Command | Integration Suite for System Center *.exe nel sistema utilizzato per gestire i client.
2. Fare clic sul file *.exe, quindi su Avanti nella schermata iniziale.
3. Accettare il contratto di licenza Microsoft, quindi fare clic su Avanti .
4. Selezionare l'opzione di installazione Personalizzata , quindi fare clic su Avanti .
5. Fare clic sulla casella di riepilogo a discesa accanto a Estensioni di Configuration Manager e selezionare l'opzione Questa funzione non sarà disponibile .
6. Fare clic su Avanti e seguire la restante parte della procedura guidata di installazione.
7. Al termine del processo di installazione, fare clic su Fine .
Installazione di Dell Command | Warranty 5
3
Avviare Dell Command | Warranty
Avviare Dell Command | Warranty utilizzando uno strumento della riga di comando.
1. Aprire un prompt dei comandi.
2. Passare alla cartella in cui sono stati collocati i file di Dell Command | Warranty.
Ad esempio, digitare: cd C:\Program Files\Dell\Command . . .
3. Digitare il nome del file eseguibile.
Ad esempio, digitare: DellWarranty-CLI.exe
6 Avviare Dell Command | Warranty
4
Configurazione di Dell Command | Warranty
Prima di utilizzare Dell Command | Warranty, effettuare le seguenti operazioni:
1. Avviare Dell Command | Warranty.
Per maggiori informazioni, consultare Avvio di Dell Command | Warranty .
2. Inserire DellWarranty-CLI.exe /H per visualizzare l'utilizzo.
N.B.: Per garantire il funzionamento di Dell Command | Warranty, è necessario fornire un parametro /InputFile o /
InputCfgMgrConnectionString . Vedere Opzioni CLI .
Configurazione di Dell Command | Warranty 7
5
Recupero delle informazioni Warranty
1. Se il sistema su cui è installato Dell Command | Warranty dispone dell'accesso a Configuration Manager ed è in grado di connettersi a
Internet (anche mediante proxy): a. Avviare Dell Command | Warranty.
Per maggiori informazioni, consultare Avvio di Dell Command | Warranty .
b. Configurare Dell Command | Warranty.
Per maggiori informazioni, consultare Configurazione di Dell Command | Warranty .
c. Per recuperare le informazioni sulla garanzia tramite il database di Configuration Manager:
● Utilizzare il comando: DellWarranty-CLI.exe /ICS="Data Source=[host];Database=[ Configuration Manager dbname];Integrated
Security=true;"
● Stringa di connessione al database Configuration Manager:
"Data Source=[host];Database=[ Configuration Manager dbname];Integrated Security=true;")
"Data Source=[host];Database=[ Configuration Manager dbname];User id=[username];Password=[userpwd]"
Per maggiori informazioni, vedere Opzioni CLI .
Le informazioni su Warranty dei sistemi client Dell vengono recuperate e salvate come file .csv nella cartella Default:
[%ProgramData%\Dell\Warranty\][WarrantyOutput_[yyyyMMddhhmmss].csv
.
N.B.: Il file viene salvato come WarrantyInformation_ YYYY _ MM _ DD .csv
(in cui YYYY è l'anno, MM è il mese e DD è il giorno).
2. Se il sistema su cui è installato Dell Command | Warranty non dispone dell'accesso a Configuration Manager, ma è in grado di connettersi a Internet (anche mediante proxy): a. Avviare Dell Command | Warranty.
Per maggiori informazioni, consultare Avvio di Dell Command | Warranty.
b. Creare un file CSV contenente i codici di matricola.
c. Per recuperare le informazioni sulla garanzia per i codici di matricola salvati nel file CSV creato nel passaggio precedente:
● Inserire il comando seguente: DellWarranty-CLI.exe /I=C:\FileName.csv
.
Le informazioni su Warranty dei sistemi client Dell vengono recuperate e salvate come file .csv nella cartella
Default: [ProgramData\Dell\Warranty\][WarrantyOutput_[yyyyMMddhhmmss].csv
. Per sovrascrivere il percorso predefinito, utilizzare l'opzione della riga di comando /Ocs . Vedere Opzioni CLI .
N.B.: Il file viene salvato come WarrantyOutput_ [yyyMMddhhmmss].csv (in cui yyyy è l'anno, MM è il mese, dd è il giorno, hh è l'ora, mm è il minuto e ss è il secondo).
N.B.: Quando si utilizza l'opzione della riga di comando /Ocs , il nome predefinito può anche essere sovrascritto.
Inoltre, se i tag non validi vengono trovati nel file di richiesta, viene creato un file %ProgramData%\Dell\Warranty\]
[WarrantyerrorOutput_[yyyyMMddhhmmss].csv
.
8 Recupero delle informazioni Warranty
A
Opzioni dell'interfaccia della riga di comando
(CLI)
Per utilizzare lo strumento Warranty, utilizzare le seguenti opzioni e sintassi della CLI.
Tabella 1. Sintassi e opzioni della CLI
Nome dell'opzione CLI Abbreviazio ne dell'opzione
CLI
/Help /H
Descrizione
/Usage
/InputFile
/U
/I
Indica di visualizzare l'utilizzo (queste informazioni).
Indica di visualizzare l'utilizzo (queste informazioni).
N.B.: Affinché lo strumento Warranty funzioni, è necessario fornire almeno uno dei due indicatori di input, /I o /Ics.
Percorso completo di un file CSV di input dei codici di matricola
(C:\FileName.csv)
Parametro richiesto: può essere utilizzato con stringa di connessione di Configuration Manager.
/InputCfgMgrConnectionString /Ics N.B.: Affinché lo strumento Warranty funzioni, è necessario fornire almeno uno dei due indicatori di input, /I o /Ics.
Stringa di connessione al database Configuration
Manager.
("Data Source=[host];Database=[Configuration
Manager dbname];Integrated Security=true;")
("Data Source=[host];Database=[ Configuration
Manager dbname];User id=[username];Password=[userpwd]")
Il parametro richiesto può essere utilizzato con il file di input CSV.
/ExportFile /E
Percorso completo di un file di esportazione CSV.
Il file conterrà le informazioni sulla garanzia dopo l'esecuzione dell'interfaccia della riga di comando.
(Default: [ProgramData\Dell\Warranty\]
[WarrantyOutput_[yyyyMMddhhmmss].csv)
(C:\WarrantyOutputFileName.csv
Il parametro è facoltativo.
/OutputConnectionString /Ocs Stringa di connessione al database Warranty di output. Conterrà le informazioni sulla garanzia dopo l'esecuzione dell'interfaccia della riga di comando.
Sintassi
DellWarranty-CLI.exe /H
DellWarranty-CLI.exe /U
DellWarranty-CLI.exe /
I=C:\FileName.csv
DellWarranty-CLI.exe /
Ics="Data
Source=[host];Database
=[ Configuration
Manager dbname];Integrated
Security=true;"
DellWarranty-
CLI.exe /I=
C:\FileName.csv /
E=C:\WarrantyOutputfile name.csv
DellWarranty-
CLI.exe /I=
C:\FileName.csv /
Ocs="Data
Source=[host];Database
Opzioni dell'interfaccia della riga di comando (CLI) 9
Tabella 1. Sintassi e opzioni della CLI (continua)
Nome dell'opzione CLI Abbreviazio ne dell'opzione
CLI
Descrizione Sintassi
("Data Source=[host];Database=[Warranty dbname];Integrated Security=true;")
Il parametro è facoltativo.
Il comando /Ocs crea un database con il nome dato come descritto in precedenza. La posizione del database è %PROFILOUTENTE%\
[Warranty dbname].mdf, mentre il file di registro è
%PROFILOUTENTE%\[Waranty dbname]_log.ldf.
Generalmente la variabile %PROFILOUTENTE% corrisponde a C: \Utenti\[nome utente]\ su un sistema Windows 10.
Una volta che il database viene creato, il comando /Ocs crea due altre tabelle: Dell_Asset e Dell_AssetEntitlement. Queste tabelle vengono utilizzate per archiviare i dati di garanzia che vengono cancellati prima, quindi vengono popolate da /InputFile o /InputCfgMgrConnectionString servicetags.
N.B.: Una volta che il database è stato creato, è possibile modificare la posizione dei file [warranty dbname].mdf e [warranty dbname] _log.ldf utilizzando il comando
SQL alter database o SQL Server
Management Studio.
=[Warranty dbname];Integrated
Security=true;"
N.B.: Se il database esiste già e le tabelle Dell_Asset e Dell_AssetEntitlement non esistono, è necessario creare le tabelle.
/Filter /F DellWarranty-
CLI.exe /I=
C:\FileName.csv /
F=ActiveWarranty
/ProxyUrl
/ProxyUser
/ProxyPwd
/Ps
/Pu
/Pd
Filtro per l'API e il DB di Warranty
(Default: AnyWarranty)
(ActiveWarranty o ExpiredWarranty o
WarrantyExpiringIn30Days)
(/F=ActiveWarranty)
Il parametro è facoltativo.
URL del server proxy
(proxy.domain.com[:port])
Il parametro è facoltativo.
Nome utente proxy
([proxy user name])
Il parametro è facoltativo.
Password utente proxy
(/Pd=[proxy user password])
Il parametro è facoltativo.
DellWarranty-
CLI.exe /I=
C:\FileName.csv /Ps= proxy.domain.com[:port]
DellWarranty-
CLI.exe /I=
C:\FileName.csv /Ps= proxy.domain.com[:port]
/Pu=[proxy user name] /
Pd=[proxy user password]
DellWarranty-
CLI.exe /I=
C:\FileName.csv /Ps= proxy.domain.com[:port]
10 Opzioni dell'interfaccia della riga di comando (CLI)
Tabella 1. Sintassi e opzioni della CLI (continua)
Nome dell'opzione CLI Abbreviazio ne dell'opzione
CLI
Descrizione
/Verbose
/Wait
/V
/W
Sintassi
/Pu=[proxy user name] /
Pd=[proxy user password]
Indica di visualizzare ulteriori informazioni durante l'esecuzione
(/V)
Il parametro è facoltativo.
DellWarranty-
CLI.exe /I=
C:\FileName.csv /V
Indica di attendere l'input dell'utente prima di terminare. È opportuno utilizzarlo durante il debug
(/W)
Il parametro è facoltativo.
DellWarranty-
CLI.exe /I=
C:\FileName.csv /W
Opzioni dell'interfaccia della riga di comando (CLI) 11
B
Schema del database di output Warranty
Il seguente dizionario di dati viene creato quando si utilizza lo switch /Ocs.
Comando di esempio: DellWarranty-CLI.exe /I=C:\Users\[username]\Documents\FileName.csv /Ocs="Data
Source=(localdb)\MSSQLLocalDB;Database=[dbname];Integrated Security=true;"
N.B.: Fornire la variabile [dbname] entro i parametri dello switch /Ocs, come illustrato sopra.
Tabella 2. Dizionario dei dati Warranty
table_name
Dell_Asset
Dell_Asset column_name
ServiceTag
BUID
Dell_Asset
Dell_Asset
Dell_Asset
Dell_Asset
Dell_Asset
Dell_Asset
Dell_Asset
Dell_AssetEntitlements
ProductId
CountryLookupCode
LOB
MachineDescription
ShipDate
LastUpdated
LastRetrieval
ServiceTag
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
Dell_AssetEntitlements
StartDate
EndDate
ItemNumber nvarchar
ServiceLevelDescription nvarchar
ServiceLevelCode nvarchar
EntitlementType
ServiceProvider
LastUpdated
LastRetrieval nvarchar nvarchar datetime nvarchar data_type nvarchar int nvarchar nvarchar nvarchar nvarchar datetime datetime nvarchar nvarchar datetime datetime
8
8
100
512
256
512
256
8
100
8
512
100 data_length is_nullable Descrizione
100 0 PK
4 1 NA
100
256
512
512
8
1
1
1
1
1
NA
NA
NA
NA
NA
1
1
0
1
1
1
1
1
1
1
1
1
NA
NA
FK con [dbo].[Dell_Asset]
[ServiceTag]. Inoltre, in
ON UPDATE CASCADEON
DELETE CASCADE
NA
Campo utilizzato per determinare i filtri
Warranty: AnyWarranty,
ActiveWarranty,
ExpiredWarranty, o
WarrantyExpiringIn30Days
NA
NA
NA
NA
NA
NA
NA
12 Schema del database di output Warranty
