Adding Netsh Support to a Run-Time Image

5/10/2007

By using the Net Shell (Netsh) utility, you can configure the IP addresses, netmasks, gateways, and additional protocols and services on your run-time image. By adding Net Shell support to your run-time image, you can configure networking on your target device after your run-time image is deployed.

In Target Designer, a run-time image defaults to Dynamic Host Configuration Protocol (DHCP). To configure a static IP address, or configure multiple networking cards, you must use the Netsh command after the run-time image is deployed.

Note

You cannot set a static IP address in Target Designer because every target device you deploy your run time image to would have the same IP address. Each IP address must be configured individually.

To add Net Shell to a run-time image

  1. To enable the Netsh utility, as well as the interface context commands, add the following components to your run-time image:

    • CMD - Windows Command Processor
    • Network Command Shell
    • Network Command Shell Interface Context
    • IP Router Monitor Library

    Additional Net Shell components add support for different Net Shell contexts, which are categories of network protocols, services, or utilities related to a particular feature, as follows:

    • Home Networking Monitory Library (bridge context)
    • Network Diagnostics (diag context)
    • Remote Access Monitory (ras context)

    Additionally, the following TCP/IP component is recommended:

    • TCP/IP Utilities
  2. After adding these components, check dependencies and rebuild your image. After deploying your run-time image

  1. To enable the Netsh utility, as well as the interface context commands, add the following components to your run-time image:

    • CMD - Windows Command Processor
    • Network Command Shell
    • Network Command Shell Interface Context
    • IP Router Monitor Library

    Additional Net Shell components add support for different Net Shell contexts, which are categories of network protocols, services, or utilities related to a particular feature, as follows:

    • Home Networking Monitory Library (bridge context)
    • Network Diagnostics (diag context)
    • Remote Access Monitory (ras context)

    Additionally, the following TCP/IP component is recommended:

    • TCP/IP Utilities
  2. After adding these components, check dependencies and rebuild your image. After deploying your run-time image

See Also

Concepts

How to Configure a Static IP Address on a Run-Time Image

Other Resources

Network Configuration