VirtualBox

source: vbox/trunk/doc/manual/en_US/dita/topics/changedmi.dita@ 105145

Last change on this file since 105145 was 99797, checked in by vboxsync, 21 months ago

Docs: bugref:10302. Merging changes from the docs team. Almost exclusively conkeyref related stuff.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.4 KB
Line 
1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
3<topic xml:lang="en-us" id="changedmi">
4 <title>Configuring the BIOS DMI Information</title>
5
6 <body>
7 <p>
8 The DMI data that <ph conkeyref="vbox-conkeyref-phrases/product-name"/> provides to guests can be changed
9 for a specific VM. Use the following commands to configure the DMI
10 BIOS information. In case your VM is configured to use EFI
11 firmware you need to replace <codeph>pcbios</codeph> by
12 <codeph>efi</codeph> in the keys.
13 </p>
14 <ul>
15 <li>
16 <p>
17 DMI BIOS information (type 0)
18 </p>
19 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
20"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSVendor" "BIOS Vendor"
21$ VBoxManage setextradata <varname>VM-name</varname> \
22"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSVersion" "BIOS Version"
23$ VBoxManage setextradata <varname>VM-name</varname> \
24"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSReleaseDate" "BIOS Release Date"
25$ VBoxManage setextradata <varname>VM-name</varname> \
26"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSReleaseMajor" 1
27$ VBoxManage setextradata <varname>VM-name</varname> \
28"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSReleaseMinor" 2
29$ VBoxManage setextradata <varname>VM-name</varname> \
30"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSFirmwareMajor" 3
31$ VBoxManage setextradata <varname>VM-name</varname> \
32"VBoxInternal/Devices/pcbios/0/Config/DmiBIOSFirmwareMinor" 4</pre>
33 </li>
34 <li>
35 <p>
36 DMI system information (type 1)
37 </p>
38 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
39"VBoxInternal/Devices/pcbios/0/Config/DmiSystemVendor" "System Vendor"
40$ VBoxManage setextradata <varname>VM-name</varname> \
41"VBoxInternal/Devices/pcbios/0/Config/DmiSystemProduct" "System Product"
42$ VBoxManage setextradata <varname>VM-name</varname> \
43"VBoxInternal/Devices/pcbios/0/Config/DmiSystemVersion" "System Version"
44$ VBoxManage setextradata <varname>VM-name</varname> \
45"VBoxInternal/Devices/pcbios/0/Config/DmiSystemSerial" "System Serial"
46$ VBoxManage setextradata <varname>VM-name</varname> \
47"VBoxInternal/Devices/pcbios/0/Config/DmiSystemSKU" "System SKU"
48$ VBoxManage setextradata <varname>VM-name</varname> \
49"VBoxInternal/Devices/pcbios/0/Config/DmiSystemFamily" "System Family"
50$ VBoxManage setextradata <varname>VM-name</varname> \
51"VBoxInternal/Devices/pcbios/0/Config/DmiSystemUuid" \
52"9852bf98-b83c-49db-a8de-182c42c7226b"</pre>
53 </li>
54 <li>
55 <p>
56 DMI board information (type 2)
57 </p>
58 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
59"VBoxInternal/Devices/pcbios/0/Config/DmiBoardVendor" "Board Vendor"
60$ VBoxManage setextradata <varname>VM-name</varname> \
61"VBoxInternal/Devices/pcbios/0/Config/DmiBoardProduct" "Board Product"
62$ VBoxManage setextradata <varname>VM-name</varname> \
63"VBoxInternal/Devices/pcbios/0/Config/DmiBoardVersion" "Board Version"
64$ VBoxManage setextradata <varname>VM-name</varname> \
65"VBoxInternal/Devices/pcbios/0/Config/DmiBoardSerial" "Board Serial"
66$ VBoxManage setextradata <varname>VM-name</varname> \
67"VBoxInternal/Devices/pcbios/0/Config/DmiBoardAssetTag" "Board Tag"
68$ VBoxManage setextradata <varname>VM-name</varname> \
69"VBoxInternal/Devices/pcbios/0/Config/DmiBoardLocInChass" "Board Location"
70$ VBoxManage setextradata <varname>VM-name</varname> \
71"VBoxInternal/Devices/pcbios/0/Config/DmiBoardBoardType" 10</pre>
72 </li>
73 <li>
74 <p>
75 DMI system enclosure or chassis (type 3)
76 </p>
77 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
78"VBoxInternal/Devices/pcbios/0/Config/DmiChassisVendor" "Chassis Vendor"
79$ VBoxManage setextradata <varname>VM-name</varname> \
80"VBoxInternal/Devices/pcbios/0/Config/DmiChassisType" 3
81$ VBoxManage setextradata <varname>VM-name</varname> \
82"VBoxInternal/Devices/pcbios/0/Config/DmiChassisVersion" "Chassis Version"
83$ VBoxManage setextradata <varname>VM-name</varname> \
84"VBoxInternal/Devices/pcbios/0/Config/DmiChassisSerial" "Chassis Serial"
85$ VBoxManage setextradata <varname>VM-name</varname> \
86"VBoxInternal/Devices/pcbios/0/Config/DmiChassisAssetTag" "Chassis Tag"</pre>
87 </li>
88 <li>
89 <p>
90 DMI processor information (type 4)
91 </p>
92 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
93"VBoxInternal/Devices/pcbios/0/Config/DmiProcManufacturer" "GenuineIntel"
94$ VBoxManage setextradata <varname>VM-name</varname> \
95"VBoxInternal/Devices/pcbios/0/Config/DmiProcVersion" "Pentium(R) III"</pre>
96 </li>
97 <li>
98 <p>
99 DMI OEM strings (type 11)
100 </p>
101 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
102"VBoxInternal/Devices/pcbios/0/Config/DmiOEMVBoxVer" "vboxVer_1.2.3"
103$ VBoxManage setextradata <varname>VM-name</varname> \
104"VBoxInternal/Devices/pcbios/0/Config/DmiOEMVBoxRev" "vboxRev_12345"</pre>
105 </li>
106 </ul>
107 <p>
108 If a DMI string is not set, the default value of <ph conkeyref="vbox-conkeyref-phrases/product-name"/> is
109 used. To set an empty string use
110 <codeph>"&lt;EMPTY&gt;"</codeph>.
111 </p>
112 <p>
113 Note that in the above list, all quoted parameters (DmiBIOSVendor,
114 DmiBIOSVersion but not DmiBIOSReleaseMajor) are expected to be
115 strings. If such a string is a valid number, the parameter is
116 treated as number and the VM will most probably refuse to start
117 with an <codeph>VERR_CFGM_NOT_STRING</codeph> error. In that
118 case, use
119 <codeph>"string:<varname>value</varname>"</codeph>. For
120 example:
121 </p>
122 <pre xml:space="preserve">$ VBoxManage setextradata <varname>VM-name</varname> \
123"VBoxInternal/Devices/pcbios/0/Config/DmiSystemSerial" "string:1234"</pre>
124 <p>
125 Changing this information can be necessary to provide the DMI
126 information of the host to the guest to prevent Windows from
127 asking for a new product key. On Linux hosts, the DMI BIOS
128 information can be obtained with the following command:
129 </p>
130 <pre xml:space="preserve">$ dmidecode -t0</pre>
131 <p>
132 The DMI system information can be obtained as follows:
133 </p>
134 <pre xml:space="preserve">$ dmidecode -t1</pre>
135 </body>
136
137</topic>
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette