From 7ec0d59c30ae508302320d390285785096779004 Mon Sep 17 00:00:00 2001 From: Jordan Borean Date: Thu, 26 Mar 2020 04:09:32 +1000 Subject: [PATCH] windows - add docs for UNC path in PSModulePath error (#68421) --- docs/docsite/rst/user_guide/windows_setup.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/docsite/rst/user_guide/windows_setup.rst b/docs/docsite/rst/user_guide/windows_setup.rst index 2ac1833caef..fa9ec3d5d6a 100644 --- a/docs/docsite/rst/user_guide/windows_setup.rst +++ b/docs/docsite/rst/user_guide/windows_setup.rst @@ -436,6 +436,20 @@ Sometimes an installer may restart the WinRM or HTTP service and cause this erro best way to deal with this is to use ``win_psexec`` from another Windows host. +Failure to Load Builtin Modules ++++++++++++++++++++++++++++++++ +If powershell fails with an error message similar to ``The 'Out-String' command was found in the module 'Microsoft.PowerShell.Utility', but the module could not be loaded.`` +then there could be a problem trying to access all the paths specified by the ``PSModulePath`` environment variable. +A common cause of this issue is that the ``PSModulePath`` environment variable contains a UNC path to a file share and +because of the double hop/credential delegation issue the Ansible process cannot access these folders. The way around +this problems is to either: + +* Remove the UNC path from the ``PSModulePath`` environment variable, or +* Use an authentication option that supports credential delegation like ``credssp`` or ``kerberos`` with credential delegation enabled + +See `KB4076842 `_ for more information on this problem. + + Windows SSH Setup ````````````````` Ansible 2.8 has added an experimental SSH connection for Windows managed nodes.