Enable-HcsNetInterface

Enable-HcsNetInterface

Enables a network interface.

Syntax

Parameter Set: Default
Enable-HcsNetInterface [-InterfaceAlias] <HcsNetInterfaces> {Data0 | Data1 | Data2 | Data3 | Data4 | Data5} [ <CommonParameters>]

Detailed Description

The Enable-HcsNetInterface cmdlet enables a network interface. If you previously enabled an interface and saved its settings, these settings stay in place if you disable and then enable the network interface. These settings include the IP address.

Parameters

-InterfaceAlias<HcsNetInterfaces>

Specifies an interface alias. The acceptable values for this parameter are:

-- Data0
-- Data1
-- Data2
-- Data3
-- Data4
-- Data5

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.HCS.Management.Platform.Support.NetInterfaceInfo

    The NetInterfaceInfo object has the following properties:

    -- InterfaceAlias (Data0, Data1, Data2, Data3, Data4, or Data5)
    -- IPAddress Controller0IPv4Address
    -- IPAddress Controller 0 IPv6Address
    -- IPAddress Controller 1 IPv4Address
    -- IPAddress Controller 1 IPv6Address
    -- IPAddress IPv4Address
    -- IPAddress IPv4Gateway
    -- IPAddress IPv4Netmask
    -- IPAddress IPv6Address
    -- IPAddress IPv6Gateway
    -- String IPv6Prefix
    -- IsEnabled
    -- IsCloudEnabled
    -- IsiSCSIEnabled

Examples

Example 1: Enable a network interface

This command specifes the InterfaceAlias parameter to enable the Data2 network interface.

PS C:\> Enable-HcsNetInterface Data2

Disable-HcsNetInterface

Get-HcsNetInterface

Set-HcsNetInterface