The LegacyNetworking module contains cmdlets and DSC resources for managing Windows 7 and Server 2008 R2 machines. These resources can be used to manage basic networking settings of down-level operating systems. Wherever possible, syntax compatibility with the xNetworking resources has been provided to easily replicate settings between different operating system versions.

Included Cmdlets

• Get-LegacyNetAdapater: Queries network adapters.
• Get-LegacyNetAdapaterConfiguration: Queries network adapter configurations.
• Get-LegacyNetFirewallRule: Retrieves existing firewall rule(s).
• New-LegacyNetFirewallRule: Creates a new firewall rule.
• Remove-LegacyNetFirewallRule: Removes an existing firewall rule.
• Set-LegacyNetFirewallRule: Updates an existing firewall rule.

Included Resources

• vDefaultGatewayAddress: Configures the default gateway of a network adapter.
• vDNSServerAddress: Configures the DNS server address(es) a network adapter.
• vFirewall: Manages a local firewall rule.
• vIPAddress: Manages local IP address assigned to a network adapter.

vDefaultGatewayAddress

Configures the default gateway of a network adapter.

Syntax

vDefaultGatewayAddress [String] #ResourceName
{
    Address = [string]
    InterfaceAlias = [string]
    [ AddressFamily = [string] { IPv4 } ]
}

vDNSServerAddress

Configures the DNS server address(es) a network adapter.

Syntax

vDNSServerAddress [String] #ResourceName
{
    Address = [string[]]
    InterfaceAlias = [string]
    [ AddressFamily = [string] { IPv4 } ]
}

vFirewall

Manages a local firewall rule.

Syntax

vFirewall [String] #ResourceName
{
    DisplayName = [string]
    Action = [string] { Allow | Block | Bypass }
    Direction = [string] { Inbound | Outbound }
    Profile = [string[]] { Domain | Private | Public | Any }
    [ Description = [string] ]
    [ Enabled = [string] { False | True } ]
    [ Ensure = [string] { Absent | Present } ]
    [ LocalPort = [string[]] ]
    [ Program = [string] ]
    [ Protocol = [string] ]
    [ RemotePort = [string[]] ]
    [ Service = [string] ]
}

vIPAddress

Manages local IP address assigned to a network adapter.

Syntax

vIPAddress [String] #ResourceName
{
    InterfaceAlias = [string]
    IPAddress = [string]
    SubnetMask = [uint32]
    [ AddressFamily = [string] { IPv4 } ]
}