v0.17.0-preview0006

[v0.17.0-preview0006]

Added

• Tasks for automating documentation for the GitHub repository wiki (issue #110).
• Set-PSModulePath
  • A new parameters set takes two parameters FromTarget and ToTarget
    that can copy from omne target to the other (issue #102).
  • A new parameter PassThru that, if specified, returns the path that
    was set.
• New-Exception
  • New command that creates and returns an [System.Exception].
• New-ErrorRecord
  • New command that creates and returns an [System.Management.Automation.ErrorRecord]
    (issue #99).
• New-ArgumentException
  • Now takes a parameter PassThru that returns the error record that was
    created (and does not throw).
• New-InvalidOperationException
  • Now takes a parameter PassThru that returns the error record that was
    created (and does not throw) (issue #98).
• New-InvalidResultException
  • Now takes a parameter PassThru that returns the error record that was
    created (and does not throw).
• New-NotImplementedException
  • Now takes a parameter PassThru that returns the error record that was
    created (and does not throw).
• Compare-DscParameterState
  • Add support for the type [System.Collections.Specialized.OrderedDictionary]
    passed to parameters CurrentValues and DesiredValues (issue #57).
  • Add support for DesiredValues (and CurrentValues) to pass a value,
    e.g a hashtable, that includes a property with the type [System.Collections.Specialized.OrderedDictionary]
    or an array of [System.Collections.Specialized.OrderedDictionary] (issue #57).

Changed

• Updated the pipelines files for resolving dependencies.
• Command documentation was moved from README to GitHub repository wiki.
• Change the word cmdlet to command throughout in the documentation, code
  and localization strings.
• A meta task now removes the built module from the session if it is imported.
• Wiki source file HOME was modified to not link to README for help after
  command documentation now is in the wiki.
• Get-LocalizedData
  • Refactored to simplify execution and debugging. The command previously
    used a steppable pipeline (proxies Import-LocalizedData), that was
    removed since it was not possible to use the command in a pipeline.
    It just made it more complex and harder to debug. There are more
    debug messages added to hopefully simplify solving some hard to find
    edge cases bugs.
• New-ArgumentException
  • Now has a command alias New-InvalidArgumentException and the command
    was renamed to match the exception name.
  • Now uses the new command New-ErrorRecord.
• New-InvalidDataException
  • The parameter Message has a parameter alias ErrorMessage to make
    the command have the same parameter names as the other New-*Exception
    commands.
  • Now uses the new command New-ErrorRecord.
• New-InvalidOperationException
  • Now uses the new command New-ErrorRecord.
• New-InvalidResultException
  • Now uses the new command New-ErrorRecord.
• New-NotImplementedException
  • Now uses the new command New-ErrorRecord.
• New-ObjectNotFoundException
  • Now uses the new command New-ErrorRecord.

Fixed

• Assert-BoundParameter
  • Fixed example in documentation that were referencing an invalid command name.
• Get-LocalizedData
  • One debug message was wrongly using a format operator (issue #111.
• New-ObjectNotFoundException
  • Updated typo in comment-based help.