feat: Use-Module ( Fixes #1130 )

Fixing parameters and fulfilling promise

Author: StartAutomating

docs/Use-Module.md

@@ -0,0 +1,68 @@
+Use-Module
+----------
+
+### Synopsis
+Uses a module.
+
+---
+
+### Description
+
+Uses a module.  
+
+This can either:
+
+* If present, run a module's `Use` function, method, or script property.
+* Otherwise, run a script block in the module's context.
+
+* Run a module's `Use` function, if present
+* Call a module's `Use` method, if present
+
+In all cases, the script block should be run in the module's context, using dot-sourcing.
+
+---
+
+### Examples
+> EXAMPLE 1
+
+```PowerShell
+Get-Module PipeScript | Use-Module -ScriptBlock { $myInvocation.MyCommand.ScriptBlock.Module }
+```
+
+---
+
+### Parameters
+#### **Name**
+The name of the module
+
+|Type      |Required|Position|PipelineInput |Aliases   |
+|----------|--------|--------|--------------|----------|
+|`[String]`|false   |1       |true (ByValue)|ModuleName|
+
+#### **ScriptBlock**
+The script block to use.
+
+|Type           |Required|Position|PipelineInput|
+|---------------|--------|--------|-------------|
+|`[ScriptBlock]`|false   |2       |false        |
+
+#### **ArgumentList**
+The list of arguments to pass to the script block.
+
+|Type          |Required|Position|PipelineInput|Aliases           |
+|--------------|--------|--------|-------------|------------------|
+|`[PSObject[]]`|false   |3       |false        |Arguments<br/>Args|
+
+#### **Parameter**
+Any named parameters to pass to the script block.
+
+|Type           |Required|Position|PipelineInput        |Aliases   |
+|---------------|--------|--------|---------------------|----------|
+|`[IDictionary]`|false   |4       |true (ByPropertyName)|Parameters|
+
+---
+
+### Syntax
+```PowerShell
+Use-Module [[-Name] <String>] [[-ScriptBlock] <ScriptBlock>] [[-ArgumentList] <PSObject[]>] [[-Parameter] <IDictionary>] [<CommonParameters>]
+```