Dell Command | Warranty
User’s Guide
June 2021
Rev. A01
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 2021 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.
Contents
Chapter 1: Dell Command | Warranty ............................................................................................ 4
Supported client operating systems............................................................................................................................... 4
Supported server operating systems..............................................................................................................................4
Chapter 2: Installing Dell Command | Warranty ............................................................................ 5
Installing Dell Command | Warranty as part of Dell Command | Integration Suite for System Center ......... 5
Installing Dell Command | Warranty as a stand-alone application........................................................................... 5
Chapter 3: Launching Dell Command | Warranty ...........................................................................6
Chapter 4: Configuring Dell Command | Warranty......................................................................... 7
Chapter 5: Retrieving warranty information.................................................................................. 8
Appendix A: Command-line interface (CLI) options....................................................................... 9
Appendix B: Warranty output database schema............................................................................12
Contents 3
1
Dell Command | Warranty
The Dell Command | Warranty can be installed as a stand-alone application or part of the Dell Command | Integration Suite for System Center on systems running Microsoft System Center 2012 Configuration Manager, System Center 2012 SP1
Configuration Manager, System Center 2012 R2 Configuration Manager, and Microsoft System Center Current Branch. Dell
Command | Warranty helps you to retrieve the warranty information for a list of client systems stored in the Configuration
Manager’s database, or in a file. Client systems are specified by their Service Tags.
Topics:
•
Supported client operating systems
•
Supported server operating systems
Supported client operating systems
● Windows 10 32-bit
● Windows 10 64-bit
● Windows 10 32-bit Professional
● Windows 10 64-bit Professional
● Windows 10 32-bit Enterprise
● Windows 10 64-bit Enterprise
● Windows 8.1 32-bit
● Windows 8.1 64-bit
● Windows 8.1 32-bit Professional
● Windows 8.1 64-bit Professional
● Windows 8.1 32-bit Enterprise
● Windows 8.1 64-bit Enterprise
● Windows 8 32-bit
● Windows 8 64-bit
● Windows 8 32-bit Professional
● Windows 8 64-bit Professional
● Windows 7 32-bit Professional
● Windows 7 64-bit Professional
● Windows 7 32-bit Ultimate
● Windows 7 64-bit Ultimate
Supported server operating systems
● Windows Server 2019
● Windows Server 2016
● Windows Server 2012 R2
● Windows Server 2012
4 Dell Command | Warranty
2
Installing Dell Command | Warranty
Dell Command | Warranty can be installed either as a stand-alone application, or as part of the Dell Command | Integration Suite for System Center on systems running Microsoft System Center 2012 Configuration Manager.
NOTE: You must be logged in as the system administrator to install Dell Command | Warranty.
Topics:
•
Installing Dell Command | Warranty as part of Dell Command | Integration Suite for System Center
•
Installing Dell Command | Warranty as a stand-alone application
Installing Dell Command | Warranty as part of Dell
Command | Integration Suite for System Center
1. Download and save the Dell Command | Integration Suite for System Center .exe file to the system you use to manage your clients.
2. Click the *.exe file, and then click Next at the welcome screen.
3. Accept the License Agreement, and then click Next .
4. Select the Complete installation option, and then click Next .
5. Follow the remainder of the installation wizard process.
6. When the installation process has completed, click Finish .
Installing Dell Command | Warranty as a stand-alone application
1. Download and save the Dell Command | Integration Suite for System Center *.exe file to the system you use to manage your clients.
2. Click the *.exe file, and then click Next at the welcome screen.
3. Accept the License Agreement, and then click Next .
4. Select the Custom installation option, and then click Next .
5. Click the drop-down box beside Configuration Manager Extensions , and select the This feature will not be available option.
6. Click Next , and follow the remainder of the installation wizard process.
7. When the installation process has completed, click Finish .
Installing Dell Command | Warranty 5
3
Launching Dell Command | Warranty
Launch Dell Command | Warranty using a command-line tool.
1. Open a command prompt.
2. Go to the folder in which you have placed the Dell Command | Warranty files.
For example, type: cd C:\Program Files\Dell\Command . . .
3. Type the name of the executable file.
For example, type: DellWarranty-CLI.exe
6 Launching Dell Command | Warranty
4
Configuring Dell Command | Warranty
Before you use Dell Command | Warranty, do the following:
1. Launch Dell Command | Warranty.
For more information, see Launching Dell | Command Warranty .
2. Enter DellWarranty-CLI.exe /H to display usage.
NOTE: For Dell Command | Warranty to function you must provide an /InputFile or an /InputCfgMgrConnectionString parameter. See CLI Options .
Configuring Dell Command | Warranty 7
5
Retrieving warranty information
1. If the system on which Dell Command | Warranty is installed has access to Configuration Manager and connects to the
Internet (including through proxy): a. Launch Dell Command | Warranty.
For more information, see Launching Dell Command | Warranty .
b. Configure Dell Command | Warranty.
For more information, see Configuring Dell Command | Warranty .
c. To retrieve the warranty information through the Configuration Manager database:
● Use the command: DellWarranty-CLI.exe /ICS=”Data Source=[host];Database=[ Configuration Manager dbname];Integrated Security=true;”
● Connection string to the Configuration Manager database:
"Data Source=[host];Database=[ Configuration Manager dbname];Integrated Security=true;")
"Data Source=[host];Database=[ Configuration Manager dbname];User id=[username];Password=[userpwd]"
See CLI Options for more information.
The warranty information of the Dell client systems is retrieved and saved as a .csv file in the Default:
[%ProgramData%\Dell\Warranty\][WarrantyOutput_[yyyyMMddhhmmss].csv
folder.
NOTE: The file is saved as WarrantyInformation_ YYYY _ MM _ DD .csv
(where YYYY is the year, MM is the month and DD is the day).
2. If the system on which Dell Command | Warranty is installed does not have access to Configuration Manager, but connects to the Internet (including through proxy): a. Launch Dell Command | Warranty.
For more information, see Launching Dell Command | Warranty.
b. Create a .csv file containing the service tags.
c. To retrieve the warranty information for the service tags saved in the .csv file, you created in the previous step:
● Enter the following command: DellWarranty-CLI.exe /I=C:\FileName.csv
.
The warranty information of the Dell client systems is retrieved and saved as a .csv file in the Default:
[ProgramData\Dell\Warranty\][WarrantyOutput_[yyyyMMddhhmmss].csv
folder. To override the default path, use the command-line option /Ocs . See CLI Options .
NOTE: The file is saved as WarrantyOutput_ [yyyMMddhhmmss].csv (where yyyy is the year, MM is the month, dd is the day, hh is the hour, mm is the minute, and ss is the second).
NOTE: The default name can also be overwritten when you use the command-line option /
Ocs . Also, if invalid tags are found in the request file, a %ProgramData%\Dell\Warranty\]
[WarrantyerrorOutput_[yyyyMMddhhmmss].csv
) file is created.
8 Retrieving warranty information
A
Command-line interface (CLI) options
Use the following CLI options and syntax when engaging the warranty tool.
Table 1. CLI options and syntax
CLI Option Name CLI Option
Abbreviatio n
/Help /H
Description
Display usage (this information).
/Usage
/InputFile
/U
/I
/
InputCfgMgrConnectionString
/Ics
Syntax
Display usage (this information).
NOTE: For the warranty tool to function, you must provide at least one of the two input flags, /I or /Ics.
The full path to an input CSV file of service tags
(C:\FileName.csv)
Required parameter; can be used with configuration manager connection string.
NOTE: For the warranty tool to function, you must provide at least one of the two input flags, /I or /Ics.
Connection string to the Configuration
Manager database.
("Data
Source=[host];Database=[Configuration
Manager dbname];Integrated Security=true;")
("Data
Source=[host];Database=[ Configuration
Manager dbname];User id=[username];Password=[userpwd]")
Required parameter; can be used with input
CSV file.
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;"
/ExportFile /E
The full path to a CSV export file. File will contain warranty information after CLI execution.
(Default: [ProgramData\Dell\Warranty\]
[WarrantyOutput_[yyyyMMddhhmmss].csv)
(C:\WarrantyOutputFileName.csv
The parameter is optional.
DellWarranty-CLI.exe /
I= C:\FileName.csv /
E=C:\WarrantyOutputfil ename.csv
/OutputConnectionString /Ocs
Connection string to the output warranty database. Will contain warranty information after CLI execution.
("Data Source=[host];Database=[Warranty dbname];Integrated Security=true;")
DellWarranty-CLI.exe /
I= C:\FileName.csv /
Ocs="Data
Source=[host];Database
=[Warranty
Command-line interface (CLI) options 9
Table 1. CLI options and syntax (continued)
CLI Option Name CLI Option
Abbreviatio n
Description Syntax
The parameter is optional.
The /Ocs command creates a database with the name given as above. The location of the database is %USERPROFILE%
\[Warranty dbname].mdf, while the log file is
%USERPROFILE%\[Waranty dbname]_log.ldf.
The %USERPROFILE% variable is typically C:
\Users\[username]\ on a Windows 10 system.
Once the database is created, the /Ocs command creates two additional tables:
Dell_Asset and Dell_AssetEntitlement. These tables are used to store warranty data that is cleared first, and then populated from your /
InputFile or /InputCfgMgrConnectionString servicetags.
NOTE: Once the database has been created, you can change the location of your [warranty dbname].mdf and
[Warranty dbname]_log.ldf files using either the SQL command, alter database , or SQL Server Management
Studio.
NOTE: If the database already exists and the Dell_Asset and Dell_AssetEntitlement tables do not exist, then you must create the tables.
dbname];Integrated
Security=true;"
/Filter
/ProxyUrl
/F
/Ps
Filter for the warranty API and DB
(Default: AnyWarranty)
(ActiveWarranty or ExpiredWarranty or
WarrantyExpiringIn30Days)
(/F=ActiveWarranty)
The parameter is optional.
Proxy Server URL
(proxy.domain.com[:port])
The parameter is optional.
DellWarranty-
CLI.exe /I=
C:\FileName.csv /
F=ActiveWarranty
/ProxyUser
/ProxyPwd
/Pu
/Pd
Proxy User Name
([proxy user name])
The parameter is optional.
Proxy User Password
(/Pd=[proxy user password])
The parameter is optional.
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
] /Pu=[proxy user
10 Command-line interface (CLI) options
Table 1. CLI options and syntax (continued)
CLI Option Name CLI Option
Abbreviatio n
Description
/Verbose
/Wait
/V
/W
Syntax
Display additional information while executing
(/V)
The parameter is optional.
Wait for user input before terminating - best used when debugging
(/W)
The parameter is optional.
name] /Pd=[proxy user password]
DellWarranty-
CLI.exe /I= C:
\FileName.csv /V
DellWarranty-
CLI.exe /I= C:
\FileName.csv /W
Command-line interface (CLI) options 11
B
Warranty output database schema
The following data dictionary is created when you use the /Ocs switch.
Sample command: DellWarranty-CLI.exe /I=C:\Users\[username]\Documents\FileName.csv /Ocs="Data
Source=(localdb)\MSSQLLocalDB;Database=[dbname];Integrated Security=true;"
NOTE: Supply the variable [dbname] within the /Ocs switch parameters as illustrated by the above.
Table 2. Warranty data dictionary
table_name column_name data_type
Dell_Asset
Dell_Asset
Dell_Asset
Dell_Asset
Dell_Asset
ServiceTag
BUID
ProductId
CountryLookupCode
LOB
Dell_Asset
Dell_Asset
Dell_Asset
MachineDescription
ShipDate
LastUpdated
Dell_Asset LastRetrieval
Dell_AssetEntitlements ServiceTag
Dell_AssetEntitlements StartDate
Dell_AssetEntitlements EndDate nvarchar int nvarchar nvarchar nvarchar nvarchar datetime datetime nvarchar nvarchar datetime datetime
Dell_AssetEntitlements ItemNumber nvarchar
Dell_AssetEntitlements ServiceLevelDescription nvarchar
Dell_AssetEntitlements ServiceLevelCode
Dell_AssetEntitlements EntitlementType nvarchar nvarchar
Dell_AssetEntitlements ServiceProvider
Dell_AssetEntitlements LastUpdated
Dell_AssetEntitlements LastRetrieval nvarchar datetime nvarchar
8
8
100
512
256
512
256
8
100
512
8
8
512
100 data_lengt h
100
4
100
256
512 is_nullable Description
0
1
1
1
1
1
1
1
1
0
1
1
1
1
1
1
1
1
1
PK
NA
NA
NA
NA
NA
NA
NA
NA
NA
NA
NA
NA
NA
NA
NA
FK with
[dbo].[Dell_Asset]
[ServiceTag]. Also, on ON UPDATE
CASCADEON DELETE
CASCADE
NA
Field used to determine
Warranty Filters
AnyWarranty,
ActiveWarranty,
ExpiredWarranty, or
WarrantyExpiringIn30Day s
12 Warranty output database schema
