community.windows.win_dotnet_ngen – Runs ngen to recompile DLLs after .NET updates

Note

This plugin is part of the community.windows collection (version 1.9.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.windows.

To use it in a playbook, specify: community.windows.win_dotnet_ngen.

Synopsis

Notes

Note

  • There are in fact two scheduled tasks for ngen but they have no triggers so aren’t a problem.

  • There’s no way to test if they’ve been completed.

  • The stdout is quite likely to be several megabytes.

Examples

- name: Run ngen tasks
  community.windows.win_dotnet_ngen:

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
dotnet_ngen64_eqi_exit_code
integer
64-bit ngen executable exists
The exit code after running the 64-bit ngen.exe executeQueuedItems command.

dotnet_ngen64_eqi_output
string
64-bit ngen executable exists
The stdout after running the 64-bit ngen.exe executeQueuedItems command.

Sample:
sample output
dotnet_ngen64_update_exit_code
integer
64-bit ngen executable exists
The exit code after running the 64-bit ngen.exe update /force command.

dotnet_ngen64_update_output
string
64-bit ngen executable exists
The stdout after running the 64-bit ngen.exe update /force command.

Sample:
sample output
dotnet_ngen_eqi_exit_code
integer
32-bit ngen executable exists
The exit code after running the 32-bit ngen.exe executeQueuedItems command.

dotnet_ngen_eqi_output
string
32-bit ngen executable exists
The stdout after running the 32-bit ngen.exe executeQueuedItems command.

Sample:
sample output
dotnet_ngen_update_exit_code
integer
32-bit ngen executable exists
The exit code after running the 32-bit ngen.exe update /force command.

dotnet_ngen_update_output
string
32-bit ngen executable exists
The stdout after running the 32-bit ngen.exe update /force command.

Sample:
sample output


Authors

  • Peter Mounce (@petemounce)