DeviceForm

Article
04/11/2023

Warning

This field should be populated via a driver or similar means that is sustainable and resilient to clean install, accidental deletion, or OS migration issue. Windows does not migrate this field, so if this has been previously declared via unattend.xml, it will be lost on a subsequent OS upgrade.

Use DeviceForm to specify the device form factor running Windows 10.

To support the following features or components, set the value from the table below. For example, if you want to create an image for Retail demo mode, the DeviceForm value should be set to 20 or “Kiosk”. Likewise, if you are creating an image for a vending machine, DeviceForm should be set to 28, or “Vending”.

Values

Value	Device form	Description
0	Unknown	Use this value if your device does not fit into any of the other device form factors.
1	Phone	A typical smartphone combines cellular connectivity, a touch screen, rechargeable power source, and other components into a single chassis.
2	Tablet	A device with an integrated screen that's less than 18". It combines a touch screen, rechargeable power source, and other components into a single chassis that wouldn't meet the classification of a detachable (6) or a convertible (5).
3	Desktop	A desktop PC form factor traditional comes in an upright tower or small desktop chassis and does not have an integrated screen.
4	Notebook	A notebook is a portable clamshell device with an attached keyboard that cannot be removed.
5	Convertible	A convertible device is an evolution of the traditional notebook where the keyboard can be swiveled, rotated or flipped, but not completely removed. It is a blend between a traditional notebook and tablet, also called a 2-in-1.
6	Detachable	A detachable device is an evolution of the traditional notebook where the keyboard can be completely removed. It is a blend between a traditional notebook and tablet, also called a 2-in-1.
7	All-in-One	An All-in-One device is an evolution of the traditional desktop with an attached display.
8	Stick PC	A device that turns your TV into a Windows computer. Plug the stick into the HDMI slot on the TV and connect a USB or Bluetooth keyboard or mouse.
9	Puck	A small-size PC that users can use to plug in a monitor and keyboard.
10	Surface Hub	Microsoft Surface Hub
11	Head-mounted display	A holographic computer that is completely untethered - no wires, phones, or connection to a PC needed.
12	Industry handheld	A device screen less than 7” diagonal designed for industrial solutions. May or may not have a cellular stack.
13	Industry tablet	A device with an integrated screen greater than 7” diagonal and no attached keyboard designed for industrial solutions as opposed to consumer personal computer. May or may not have a cellular stack.
14	Banking	A machine at a bank branch or another location that enables customers to perform basic banking activities including withdrawing money and checking one's bank balance.
15	Building automation	A controller for industrial environments that can include the scheduling and automatic operation of certain systems such as conferencing, heating and air conditioning, and lighting.
16	Digital signage	A computer or playback device that's connected to a large digital screen and displays video or multimedia content for informational or advertising purposes.
17	Gaming	A device that's used for playing a game. It can be mechanical, electronic, or electromechanical equipment.
18	Home automation	A controller that can include the scheduling and automatic operation of certain systems including heating and air conditioning, security, and lighting.
19	Industrial automation	Computers that are used to automate manufacturing systems such as controlling an assembly line where each station is occupied by industrial robots.
20	Kiosk	An unattended structure that can include a keyboard and touch screen and provides a user interface to display interactive information and allow users to get more information.
21	Maker board	A low-cost and compact development board that's used for prototyping any number IoT-related things.
22	Medical	Devices built specifically to provide medical staff with information about the health and well-being of a patient.
23	Networking	A device or software that determines where messages, packets, and other signals will go next.
24	Point of Service	An electronic cash register or self-service checkout.
25	Printing	A printer, copy machine, or a combination of both.
26	Thin client	A device that connects to a server to perform computing tasks as opposed to running apps locally.
27	Toy	A device used solely for enjoyment or entertainment.
28	Vending	A machine that dispenses items in exchange for payment in the form of coin, currency, or credit/debit card.
29	Industry other	A device that doesn't fit into any of the previous categories.

Valid Configuration Passes

generalize

specialize

auditSystem

oobeSystem

Parent Hierarchy

Microsoft-Windows-Deployment | DeviceForm

Applies To

For a list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Deployment.

XML Example

<settings pass="specialize">
    <component name="Microsoft-Windows-Deployment" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <DeviceForm>3</DeviceForm>
    </component>
</settings>

Microsoft-Windows-Deployment