mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-07-23 05:10:22 -07:00
E501 fixes (#22879)
This commit is contained in:
parent
4fdeade389
commit
3164e8b561
215 changed files with 1328 additions and 761 deletions
|
@ -64,7 +64,9 @@ options:
|
|||
default: none
|
||||
rights:
|
||||
description:
|
||||
- The rights/permissions that are to be allowed/denyed for the specified user or group for the given src file or directory. Can be entered as a comma separated list (Ex. "Modify, Delete, ExecuteFile"). For more information on the choices see MSDN FileSystemRights Enumeration.
|
||||
- The rights/permissions that are to be allowed/denyed for the specified user or group for the given src file or directory.
|
||||
Can be entered as a comma separated list (Ex. "Modify, Delete, ExecuteFile"). For more information on the choices see MSDN FileSystemRights
|
||||
Enumeration.
|
||||
required: yes
|
||||
choices:
|
||||
- AppendData
|
||||
|
@ -91,7 +93,8 @@ options:
|
|||
default: none
|
||||
inherit:
|
||||
description:
|
||||
- Inherit flags on the ACL rules. Can be specified as a comma separated list (Ex. "ContainerInherit, ObjectInherit"). For more information on the choices see MSDN InheritanceFlags Enumeration.
|
||||
- Inherit flags on the ACL rules. Can be specified as a comma separated list (Ex. "ContainerInherit, ObjectInherit"). For more information on
|
||||
the choices see MSDN InheritanceFlags Enumeration.
|
||||
required: no
|
||||
choices:
|
||||
- ContainerInherit
|
||||
|
|
|
@ -48,8 +48,10 @@ options:
|
|||
default: absent
|
||||
reorganize:
|
||||
description:
|
||||
- For P(state) = I(absent), indicates if the inherited ACE's should be copied from the parent directory. This is necessary (in combination with removal) for a simple ACL instead of using multiple ACE deny entries.
|
||||
- For P(state) = I(present), indicates if the inherited ACE's should be deduplicated compared to the parent directory. This removes complexity of the ACL structure.
|
||||
- For P(state) = I(absent), indicates if the inherited ACE's should be copied from the parent directory. This is necessary
|
||||
(in combination with removal) for a simple ACL instead of using multiple ACE deny entries.
|
||||
- For P(state) = I(present), indicates if the inherited ACE's should be deduplicated compared to the parent directory. This removes complexity
|
||||
of the ACL structure.
|
||||
required: false
|
||||
choices:
|
||||
- no
|
||||
|
|
|
@ -51,11 +51,12 @@ options:
|
|||
description:
|
||||
- set the specified path as the current working directory before executing a command
|
||||
notes:
|
||||
- If you want to run a command through a shell (say you are using C(<),
|
||||
C(>), C(|), etc), you actually want the M(win_shell) module instead. The
|
||||
C(win_command) module is much more secure as it's not affected by the user's
|
||||
environment.
|
||||
- " C(creates), C(removes), and C(chdir) can be specified after the command. For instance, if you only want to run a command if a certain file does not exist, use this."
|
||||
- If you want to run a command through a shell (say you are using C(<),
|
||||
C(>), C(|), etc), you actually want the M(win_shell) module instead. The
|
||||
C(win_command) module is much more secure as it's not affected by the user's
|
||||
environment.
|
||||
- C(creates), C(removes), and C(chdir) can be specified after the command. For instance, if you only want to run a command if a certain file does not
|
||||
exist, use this.
|
||||
author:
|
||||
- Matt Davis
|
||||
'''
|
||||
|
|
|
@ -32,7 +32,8 @@ module: win_feature
|
|||
version_added: "1.7"
|
||||
short_description: Installs and uninstalls Windows Features on Windows Server
|
||||
description:
|
||||
- Installs or uninstalls Windows Roles or Features on Windows Server. This module uses the Add/Remove-WindowsFeature Cmdlets on Windows 2008 and Install/Uninstall-WindowsFeature Cmdlets on Windows 2012, which are not available on client os machines.
|
||||
- Installs or uninstalls Windows Roles or Features on Windows Server. This module uses the Add/Remove-WindowsFeature Cmdlets on Windows 2008
|
||||
and Install/Uninstall-WindowsFeature Cmdlets on Windows 2012, which are not available on client os machines.
|
||||
options:
|
||||
name:
|
||||
description:
|
||||
|
|
|
@ -41,7 +41,10 @@ options:
|
|||
regexp:
|
||||
required: false
|
||||
description:
|
||||
- "The regular expression to look for in every line of the file. For C(state=present), the pattern to replace if found; only the last line found will be replaced. For C(state=absent), the pattern of the line to remove. Uses .NET compatible regular expressions; see U(https://msdn.microsoft.com/en-us/library/hs600312%28v=vs.110%29.aspx)."
|
||||
- >
|
||||
The regular expression to look for in every line of the file. For C(state=present), the pattern to replace if found; only the last line found
|
||||
will be replaced. For C(state=absent), the pattern of the line to remove. Uses .NET compatible regular expressions;
|
||||
see U(https://msdn.microsoft.com/en-us/library/hs600312%28v=vs.110%29.aspx).
|
||||
state:
|
||||
required: false
|
||||
choices: [ present, absent ]
|
||||
|
@ -51,25 +54,30 @@ options:
|
|||
line:
|
||||
required: false
|
||||
description:
|
||||
- Required for C(state=present). The line to insert/replace into the file. If C(backrefs) is set, may contain backreferences that will get expanded with the C(regexp) capture groups if the regexp matches.
|
||||
- Required for C(state=present). The line to insert/replace into the file. If C(backrefs) is set, may contain backreferences that will get
|
||||
expanded with the C(regexp) capture groups if the regexp matches.
|
||||
backrefs:
|
||||
required: false
|
||||
default: "no"
|
||||
choices: [ "yes", "no" ]
|
||||
description:
|
||||
- Used with C(state=present). If set, line can contain backreferences (both positional and named) that will get populated if the C(regexp) matches. This flag changes the operation of the module slightly; C(insertbefore) and C(insertafter) will be ignored, and if the C(regexp) doesn't match anywhere in the file, the file will be left unchanged.
|
||||
- Used with C(state=present). If set, line can contain backreferences (both positional and named) that will get populated if the C(regexp)
|
||||
matches. This flag changes the operation of the module slightly; C(insertbefore) and C(insertafter) will be ignored, and if the C(regexp)
|
||||
doesn't match anywhere in the file, the file will be left unchanged.
|
||||
- If the C(regexp) does match, the last matching line will be replaced by the expanded line parameter.
|
||||
insertafter:
|
||||
required: false
|
||||
default: EOF
|
||||
description:
|
||||
- Used with C(state=present). If specified, the line will be inserted after the last match of specified regular expression. A special value is available; C(EOF) for inserting the line at the end of the file.
|
||||
- Used with C(state=present). If specified, the line will be inserted after the last match of specified regular expression. A special value is
|
||||
available; C(EOF) for inserting the line at the end of the file.
|
||||
- If specified regular expression has no matches, EOF will be used instead. May not be used with C(backrefs).
|
||||
choices: [ 'EOF', '*regex*' ]
|
||||
insertbefore:
|
||||
required: false
|
||||
description:
|
||||
- Used with C(state=present). If specified, the line will be inserted before the last match of specified regular expression. A value is available; C(BOF) for inserting the line at the beginning of the file.
|
||||
- Used with C(state=present). If specified, the line will be inserted before the last match of specified regular expression. A value is available;
|
||||
C(BOF) for inserting the line at the beginning of the file.
|
||||
- If specified regular expression has no matches, the line will be inserted at the end of the file. May not be used with C(backrefs).
|
||||
choices: [ 'BOF', '*regex*' ]
|
||||
create:
|
||||
|
@ -94,13 +102,19 @@ options:
|
|||
required: false
|
||||
default: "auto"
|
||||
description:
|
||||
- Specifies the encoding of the source text file to operate on (and thus what the output encoding will be). The default of C(auto) will cause the module to auto-detect the encoding of the source file and ensure that the modified file is written with the same encoding.
|
||||
- "An explicit encoding can be passed as a string that is a valid value to pass to the .NET framework System.Text.Encoding.GetEncoding() method - see U(https://msdn.microsoft.com/en-us/library/system.text.encoding%28v=vs.110%29.aspx)."
|
||||
- This is mostly useful with C(create=yes) if you want to create a new file with a specific encoding. If C(create=yes) is specified without a specific encoding, the default encoding (UTF-8, no BOM) will be used.
|
||||
- Specifies the encoding of the source text file to operate on (and thus what the output encoding will be). The default of C(auto) will cause
|
||||
the module to auto-detect the encoding of the source file and ensure that the modified file is written with the same encoding.
|
||||
- >
|
||||
An explicit encoding can be passed as a string that is a valid value to pass to the .NET framework System.Text.Encoding.GetEncoding() method - see
|
||||
U(https://msdn.microsoft.com/en-us/library/system.text.encoding%28v=vs.110%29.aspx).
|
||||
- This is mostly useful with C(create=yes) if you want to create a new file with a specific encoding. If C(create=yes) is specified without a
|
||||
specific encoding, the default encoding (UTF-8, no BOM) will be used.
|
||||
newline:
|
||||
required: false
|
||||
description:
|
||||
- "Specifies the line separator style to use for the modified file. This defaults to the windows line separator (C(\r\n)). Note that the indicated line separator will be used for file output regardless of the original line separator that appears in the input file."
|
||||
- >
|
||||
Specifies the line separator style to use for the modified file. This defaults to the windows line separator (C(\r\n)). Note that the indicated
|
||||
line separator will be used for file output regardless of the original line separator that appears in the input file.
|
||||
choices: [ "windows", "unix" ]
|
||||
default: "windows"
|
||||
notes:
|
||||
|
|
|
@ -43,7 +43,8 @@ options:
|
|||
state:
|
||||
description:
|
||||
- State of the service on the system
|
||||
- Note that NSSM actions like "pause", "continue", "rotate" do not fit the declarative style of ansible, so these should be implemented via the ansible command module
|
||||
- Note that NSSM actions like "pause", "continue", "rotate" do not fit the declarative style of ansible, so these should be implemented via the
|
||||
ansible command module
|
||||
choices:
|
||||
- present
|
||||
- started
|
||||
|
@ -57,7 +58,9 @@ options:
|
|||
- "Specify this whenever the service may need to be installed (state: present, started, stopped, restarted)"
|
||||
- "Note that the application name must look like the following, if the directory includes spaces:"
|
||||
- 'nssm install service "c:\\Program Files\\app.exe\\" "C:\\Path with spaces\\"'
|
||||
- "See commit 0b386fc1984ab74ee59b7bed14b7e8f57212c22b in the nssm.git project for more info: U(https://git.nssm.cc/?p=nssm.git;a=commit;h=0b386fc1984ab74ee59b7bed14b7e8f57212c22b)"
|
||||
- >
|
||||
See commit 0b386fc1984ab74ee59b7bed14b7e8f57212c22b in the nssm.git project for more info:
|
||||
U(https://git.nssm.cc/?p=nssm.git;a=commit;h=0b386fc1984ab74ee59b7bed14b7e8f57212c22b)
|
||||
stdout_file:
|
||||
description:
|
||||
- Path to receive output
|
||||
|
@ -84,7 +87,8 @@ options:
|
|||
- Password to be used for service startup
|
||||
start_mode:
|
||||
description:
|
||||
- If C(auto) is selected, the service will start at bootup. C(manual) means that the service will start only when another service needs it. C(disabled) means that the service will stay off, regardless if it is needed or not.
|
||||
- If C(auto) is selected, the service will start at bootup. C(manual) means that the service will start only when another service needs it.
|
||||
C(disabled) means that the service will stay off, regardless if it is needed or not.
|
||||
default: auto
|
||||
choices:
|
||||
- auto
|
||||
|
|
|
@ -34,7 +34,10 @@ author: Trond Hindenes
|
|||
short_description: Installs/Uninstalls an installable package, either from local file system or url
|
||||
description:
|
||||
- Installs or uninstalls a package.
|
||||
- 'Optionally uses a product_id to check if the package needs installing. You can find product ids for installed programs in the windows registry either in C(HKLM:Software\Microsoft\Windows\CurrentVersion\Uninstall) or for 32 bit programs C(HKLM:Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall)'
|
||||
- >
|
||||
Optionally uses a product_id to check if the package needs installing. You can find product ids for installed programs in the windows registry
|
||||
either in C(HKLM:Software\Microsoft\Windows\CurrentVersion\Uninstall) or for 32 bit programs
|
||||
C(HKLM:Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall)
|
||||
options:
|
||||
path:
|
||||
description:
|
||||
|
@ -48,7 +51,9 @@ options:
|
|||
product_id:
|
||||
description:
|
||||
- Product id of the installed package (used for checking if already installed)
|
||||
- You can find product ids for installed programs in the windows registry either in C(HKLM:Software\Microsoft\Windows\CurrentVersion\Uninstall) or for 32 bit programs C(HKLM:Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall)'
|
||||
- >
|
||||
You can find product ids for installed programs in the windows registry either in C(HKLM:Software\Microsoft\Windows\CurrentVersion\Uninstall)
|
||||
or for 32 bit programs C(HKLM:Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall)
|
||||
required: true
|
||||
aliases: [productid]
|
||||
arguments:
|
||||
|
@ -67,12 +72,14 @@ options:
|
|||
aliases: [ensure]
|
||||
user_name:
|
||||
description:
|
||||
- Username of an account with access to the package if it's located on a file share. Only needed if the winrm user doesn't have access to the package. Also specify user_password for this to function properly.
|
||||
- Username of an account with access to the package if it's located on a file share. Only needed if the winrm user doesn't have access to the package.
|
||||
Also specify user_password for this to function properly.
|
||||
default: null
|
||||
required: false
|
||||
user_password:
|
||||
description:
|
||||
- Password of an account with access to the package if it's located on a file share. Only needed if the winrm user doesn't have access to the package. Also specify user_name for this to function properly.
|
||||
- Password of an account with access to the package if it's located on a file share. Only needed if the winrm user doesn't have access to the package.
|
||||
Also specify user_name for this to function properly.
|
||||
default: null
|
||||
required: false
|
||||
expected_return_code:
|
||||
|
|
|
@ -40,11 +40,13 @@ options:
|
|||
elements:
|
||||
description:
|
||||
- A single path element, or a list of path elements (ie, directories) to add or remove.
|
||||
- When multiple elements are included in the list (and C(state) is C(present)), the elements are guaranteed to appear in the same relative order in the resultant path value.
|
||||
- When multiple elements are included in the list (and C(state) is C(present)), the elements are guaranteed to appear in the same relative order
|
||||
in the resultant path value.
|
||||
- Variable expansions (eg, C(%VARNAME%)) are allowed, and are stored unexpanded in the target path element.
|
||||
- Any existing path elements not mentioned in C(elements) are always preserved in their current order.
|
||||
- New path elements are appended to the path, and existing path elements may be moved closer to the end to satisfy the requested ordering.
|
||||
- Paths are compared in a case-insensitive fashion, and trailing backslashes are ignored for comparison purposes. However, note that trailing backslashes in YAML require quotes.
|
||||
- Paths are compared in a case-insensitive fashion, and trailing backslashes are ignored for comparison purposes. However, note that trailing
|
||||
backslashes in YAML require quotes.
|
||||
required: true
|
||||
state:
|
||||
description:
|
||||
|
|
|
@ -50,7 +50,9 @@ options:
|
|||
data:
|
||||
description:
|
||||
- Value of the registry entry C(name) in C(path).
|
||||
- Binary data should be expressed a yaml byte array or as comma separated hex values. An easy way to generate this is to run C(regedit.exe) and use the I(Export) option to save the registry values to a file. In the exported file binary values will look like C(hex:be,ef,be,ef). The C(hex:) prefix is optional.
|
||||
- Binary data should be expressed a yaml byte array or as comma separated hex values. An easy way to generate this is to run C(regedit.exe) and
|
||||
use the I(Export) option to save the registry values to a file. In the exported file binary values will look like C(hex:be,ef,be,ef).
|
||||
The C(hex:) prefix is optional.
|
||||
type:
|
||||
description:
|
||||
- Registry value data type.
|
||||
|
@ -71,7 +73,8 @@ options:
|
|||
- absent
|
||||
default: present
|
||||
notes:
|
||||
- Check-mode C(-C/--check) and diff output (-D/--diff) are supported, so that you can test every change against the active configuration before applying changes.
|
||||
- Check-mode C(-C/--check) and diff output (-D/--diff) are supported, so that you can test every change against the active configuration before
|
||||
applying changes.
|
||||
- Beware that some registry hives (HKEY_USERS in particular) do not allow to create new registry paths.
|
||||
author: "Adam Keech (@smadam813), Josh Ludwig (@joshludwig)"
|
||||
'''
|
||||
|
|
|
@ -34,7 +34,8 @@ short_description: Merges the contents of a registry file into the windows regis
|
|||
description:
|
||||
- Wraps the reg.exe command to import the contents of a registry file.
|
||||
- Suitable for use with registry files created using M(win_template).
|
||||
- Windows registry files have a specific format and must be constructed correctly with carriage return and line feed line endings otherwise they will not be merged.
|
||||
- Windows registry files have a specific format and must be constructed correctly with carriage return and line feed line endings otherwise they will not
|
||||
be merged.
|
||||
- Exported registry files often start with a Byte Order Mark which must be removed if the file is to templated using M(win_template).
|
||||
- Registry file format is described at U(https://support.microsoft.com/en-us/kb/310516)
|
||||
- See also M(win_template), M(win_regedit)
|
||||
|
@ -46,7 +47,8 @@ options:
|
|||
default: no default
|
||||
compare_key:
|
||||
description:
|
||||
- The parent key to use when comparing the contents of the registry to the contents of the file. Needs to be in HKLM or HKCU part of registry. Use a PS-Drive style path for example HKLM:\SOFTWARE not HKEY_LOCAL_MACHINE\SOFTWARE
|
||||
- The parent key to use when comparing the contents of the registry to the contents of the file. Needs to be in HKLM or HKCU part of registry.
|
||||
Use a PS-Drive style path for example HKLM:\SOFTWARE not HKEY_LOCAL_MACHINE\SOFTWARE
|
||||
If not supplied, or the registry key is not found, no comparison will be made, and the module will report changed.
|
||||
required: false
|
||||
default: no default
|
||||
|
|
|
@ -32,7 +32,8 @@ module: win_robocopy
|
|||
version_added: "2.2"
|
||||
short_description: Synchronizes the contents of two directories using Robocopy.
|
||||
description:
|
||||
- Synchronizes the contents of two directories on the remote machine. Under the hood this just calls out to RoboCopy, since that should be available on most modern Windows Systems.
|
||||
- Synchronizes the contents of two directories on the remote machine. Under the hood this just calls out to RoboCopy, since that should be available
|
||||
on most modern Windows Systems.
|
||||
options:
|
||||
src:
|
||||
description:
|
||||
|
@ -52,7 +53,8 @@ options:
|
|||
required: false
|
||||
purge:
|
||||
description:
|
||||
- Deletes any files/directories found in the destination that do not exist in the source (Toggles the `/purge` flag to RoboCopy). If "flags" is set, this will be ignored.
|
||||
- Deletes any files/directories found in the destination that do not exist in the source (Toggles the `/purge` flag to RoboCopy). If "flags" is
|
||||
set, this will be ignored.
|
||||
choices:
|
||||
- true
|
||||
- false
|
||||
|
@ -65,7 +67,8 @@ options:
|
|||
required: false
|
||||
author: Corwin Brown (@blakfeld)
|
||||
notes:
|
||||
- This is not a complete port of the "synchronize" module. Unlike the "synchronize" module this only performs the sync/copy on the remote machine, not from the master to the remote machine.
|
||||
- This is not a complete port of the "synchronize" module. Unlike the "synchronize" module this only performs the sync/copy on the remote machine,
|
||||
not from the master to the remote machine.
|
||||
- This module does not currently support all Robocopy flags.
|
||||
- Works on Windows 7, Windows 8, Windows Server 2k8, and Windows Server 2k12
|
||||
'''
|
||||
|
@ -137,7 +140,7 @@ output:
|
|||
description: The output of running the robocopy command.
|
||||
returned: success
|
||||
type: string
|
||||
sample: "-------------------------------------------------------------------------------\n ROBOCOPY :: Robust File Copy for Windows \n-------------------------------------------------------------------------------\n"
|
||||
sample: "----------------------------------------\n ROBOCOPY :: Robust File Copy for Windows \n----------------------------------------\n"
|
||||
msg:
|
||||
description: Output intrepreted into a concise message.
|
||||
returned: always
|
||||
|
|
|
@ -32,7 +32,8 @@ module: win_say
|
|||
version_added: "2.3"
|
||||
short_description: Text to speech module for Windows to speak messages and optionally play sounds
|
||||
description:
|
||||
- Uses .NET libraries to convert text to speech and optionally play .wav sounds. Audio Service needs to be running and some kind of speakers or headphones need to be attached to the windows target(s) for the speech to be audible.
|
||||
- Uses .NET libraries to convert text to speech and optionally play .wav sounds. Audio Service needs to be running and some kind of speakers or
|
||||
headphones need to be attached to the windows target(s) for the speech to be audible.
|
||||
options:
|
||||
msg:
|
||||
description:
|
||||
|
@ -41,12 +42,14 @@ options:
|
|||
default: none
|
||||
msg_file:
|
||||
description:
|
||||
- Full path to a windows format text file containing the text to be spokend. Use either msg or msg_file. Optional so that you can use this module just to play sounds.
|
||||
- Full path to a windows format text file containing the text to be spokend. Use either msg or msg_file. Optional so that you can use this module
|
||||
just to play sounds.
|
||||
required: false
|
||||
default: none
|
||||
voice:
|
||||
description:
|
||||
- Which voice to use. See notes for how to discover installed voices. If the requested voice is not available the default voice will be used. Example voice names from Windows 10 are 'Microsoft Zira Desktop' and 'Microsoft Hazel Desktop'.
|
||||
- Which voice to use. See notes for how to discover installed voices. If the requested voice is not available the default voice will be used.
|
||||
Example voice names from Windows 10 are 'Microsoft Zira Desktop' and 'Microsoft Hazel Desktop'.
|
||||
required: false
|
||||
default: system default voice
|
||||
speech_speed:
|
||||
|
@ -56,12 +59,14 @@ options:
|
|||
default: 0
|
||||
start_sound_path:
|
||||
description:
|
||||
- Full path to a C(.wav) file containing a sound to play before the text is spoken. Useful on conference calls to alert other speakers that ansible has something to say.
|
||||
- Full path to a C(.wav) file containing a sound to play before the text is spoken. Useful on conference calls to alert other speakers that ansible
|
||||
has something to say.
|
||||
required: false
|
||||
default: null
|
||||
end_sound_path:
|
||||
description:
|
||||
- Full path to a C(.wav) file containing a sound to play after the text has been spoken. Useful on conference calls to alert other speakers that ansible has finished speaking.
|
||||
- Full path to a C(.wav) file containing a sound to play after the text has been spoken. Useful on conference calls to alert other speakers that
|
||||
ansible has finished speaking.
|
||||
required: false
|
||||
default: null
|
||||
author: "Jon Hawkesworth (@jhawkesworth)"
|
||||
|
@ -112,4 +117,3 @@ voice_info:
|
|||
type: string
|
||||
sample: Could not load voice TestVoice, using system default voice
|
||||
'''
|
||||
|
||||
|
|
|
@ -50,14 +50,15 @@ options:
|
|||
- set the specified path as the current working directory before executing a command
|
||||
executable:
|
||||
description:
|
||||
- change the shell used to execute the command (eg, C(cmd)). The target shell must accept a C(/c) parameter followed by the raw command line to be executed.
|
||||
- change the shell used to execute the command (eg, C(cmd)). The target shell must accept a C(/c) parameter followed by the raw command line to be
|
||||
executed.
|
||||
notes:
|
||||
- If you want to run an executable securely and predictably, it may be
|
||||
better to use the M(win_command) module instead. Best practices when writing
|
||||
playbooks will follow the trend of using M(win_command) unless C(win_shell) is
|
||||
explicitly required. When running ad-hoc commands, use your best judgement.
|
||||
- WinRM will not return from a command execution until all child processes created have exited. Thus, it is not possible to use win_shell to spawn long-running child or background processes.
|
||||
Consider creating a Windows service for managing background processes.
|
||||
- WinRM will not return from a command execution until all child processes created have exited. Thus, it is not possible to use win_shell to spawn
|
||||
long-running child or background processes. Consider creating a Windows service for managing background processes.
|
||||
author:
|
||||
- Matt Davis
|
||||
'''
|
||||
|
|
|
@ -72,7 +72,9 @@ options:
|
|||
required: no
|
||||
default: null
|
||||
notes:
|
||||
- For extracting any compression types other than .zip, the PowerShellCommunityExtensions (PSCX) Module is required. This module (in conjunction with PSCX) has the ability to recursively unzip files within the src zip file provided and also functionality for many other compression types. If the destination directory does not exist, it will be created before unzipping the file. Specifying rm parameter will force removal of the src file after extraction.
|
||||
- For extracting any compression types other than .zip, the PowerShellCommunityExtensions (PSCX) Module is required. This module (in conjunction with PSCX)
|
||||
has the ability to recursively unzip files within the src zip file provided and also functionality for many other compression types. If the destination
|
||||
directory does not exist, it will be created before unzipping the file. Specifying rm parameter will force removal of the src file after extraction.
|
||||
author: Phil Schwartz
|
||||
'''
|
||||
|
||||
|
|
|
@ -70,7 +70,8 @@ notes:
|
|||
- win_updates must be run by a user with membership in the local Administrators group
|
||||
- win_updates will use the default update service configured for the machine (Windows Update, Microsoft Update, WSUS, etc)
|
||||
- win_updates does not manage reboots, but will signal when a reboot is required with the reboot_required return value.
|
||||
- win_updates can take a significant amount of time to complete (hours, in some cases). Performance depends on many factors, including OS version, number of updates, system load, and update server load.
|
||||
- win_updates can take a significant amount of time to complete (hours, in some cases). Performance depends on many factors, including OS version, number of
|
||||
updates, system load, and update server load.
|
||||
'''
|
||||
|
||||
EXAMPLES = r'''
|
||||
|
|
|
@ -68,7 +68,9 @@ options:
|
|||
- 'Key Value pairs for headers. Example "Host: www.somesite.com"'
|
||||
use_basic_parsing:
|
||||
description:
|
||||
- This module relies upon 'Invoke-WebRequest', which by default uses the Internet Explorer Engine to parse a webpage. There's an edge-case where if a user hasn't run IE before, this will fail. The only advantage to using the Internet Explorer praser is that you can traverse the DOM in a powershell script. That isn't useful for Ansible, so by default we toggle 'UseBasicParsing'. However, you can toggle that off here.
|
||||
- This module relies upon 'Invoke-WebRequest', which by default uses the Internet Explorer Engine to parse a webpage. There's an edge-case where if a
|
||||
user hasn't run IE before, this will fail. The only advantage to using the Internet Explorer praser is that you can traverse the DOM in a
|
||||
powershell script. That isn't useful for Ansible, so by default we toggle 'UseBasicParsing'. However, you can toggle that off here.
|
||||
choices:
|
||||
- True
|
||||
- False
|
||||
|
@ -143,7 +145,7 @@ raw_content:
|
|||
description: The raw content of the HTTP response.
|
||||
returned: success
|
||||
type: string
|
||||
sample: 'HTTP/1.1 200 OK\nX-XSS-Protection: 1; mode=block\nX-Frame-Options: SAMEORIGIN\nAlternate-Protocol: 443:quic,p=1\nAlt-Svc: quic="www.google.com:443"; ma=2592000; v="30,29,28,27,26,25",quic=":443"; ma=2...'
|
||||
sample: 'HTTP/1.1 200 OK\nX-XSS-Protection: 1; mode=block\nAlternate-Protocol: 443:quic,p=1\nAlt-Svc: quic="www.google.com:443";'
|
||||
headers:
|
||||
description: The Headers of the response.
|
||||
returned: success
|
||||
|
|
|
@ -32,7 +32,8 @@ module: win_webpicmd
|
|||
version_added: "2.0"
|
||||
short_description: Installs packages using Web Platform Installer command-line
|
||||
description:
|
||||
- Installs packages using Web Platform Installer command-line (http://www.iis.net/learn/install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release).
|
||||
- Installs packages using Web Platform Installer command-line
|
||||
(http://www.iis.net/learn/install/web-platform-installer/web-platform-installer-v4-command-line-webpicmdexe-rtw-release).
|
||||
- Must be installed and present in PATH (see win_chocolatey module; 'webpicmd' is the package name, and you must install 'lessmsi' first too)
|
||||
- Install IIS first (see win_feature module)
|
||||
notes:
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue