Home - PlagueHO/LoopbackAdapter GitHub Wiki
LoopbackAdapter PowerShell Module
Module Build Status
| Branch | AzurePipelines CI | AppVeyor CI | Code Coverage |
|---|---|---|---|
| dev |  |
||
| master |  |
Table of Contents
- Introduction
- Description
- Requirements
- Installation
- Compatibility and Testing
- Contributing
- Cmdlets
- Change Log
- Links
Introduction
A PowerShell module for creating and removing Loopback Network Adapters on Windows using Device Console (DevCon.exe).
Description
This module is used for installing and uninstalling Microsoft Loopback Network Adapters.
It uses Chocolatey to download an package called devcon.portable. This package contains a 32-bit and 64-bit version of the Windows Device Console (devcon) that can be used to install the Microsoft Loopback Network Adapter device. If Chocolatey is not installed it will be downloaded from the internet and installed automatically. The user will be asked to confirm these actions unless the -force parameter is used.
Requirements
Using this module requires:
- Local Admin - this module should be run in an Administrative PowerShell session so that it can install/uninstall hardware devices.
- *Internet Access - this module will download Chocolatey from https://chocolatey.org and then use that to install the Devcon.portable package.
Installation
To install the module from PowerShell Gallery, use the PowerShell Cmdlet:
Install-Module -Name LoopbackAdapter
Compatibility and Testing
This PowerShell module is automatically tested and validated to run on the following systems:
- Windows Server (using Windows PowerShell 5.1):
- Windows Server 2012 R2: Using AppVeyor CI.
- Windows Server 2016: Using AppVeyor CI.
- Windows Server 2016: Using Azure Pipelines.
This module should function correctly on other systems and configurations but is not automatically tested with them in every change.
Contributing
If you wish to contribute to this project, please read the Contributing.md document first. We would be very grateful of any contributions.
Cmdlets
A list of Cmdlets in the LoopbackAdapter PowerShell module can be found by running the following PowerShell commands:
Import-Module -Name LoopbackAdapter
Get-Command -Module LoopbackAdapter
Help on individual Cmdlets can be found in the built-in Cmdlet help:
Get-Help -Name Get-LoopbackAdapter
The details of the cmdlets contained in this module can also be found in the wiki.
Change Log
For a list of changes to versions, see the CHANGELOG.md file.