一、什么是Ad-hoc
称为临时命令，简单说，就是在命令行界面，直接通过一条ansible命令，去指定主机执行指定指令，功能有限 例如:ansible localhost -m command -a "df -h"
二、Ad-hoc用法
Usage: ansible <host-pattern> [options]
<host-pattern> #主机或主机组，被执行的客户端设备，必填项 [option]: -m module #【常用】模块,指定要执行使用的模块 -a #【常用】代模块参数，使用-m指定某个模块，该模块可能需要跟某些参数，此时参数就放在-a 后面的双引号内" "。不加-m 模块，直接使用-a 指默认指定了-m command 模块 -u USERNAME #--user=USERNAME：指定远程主机以USERNAME运行命令 -k #--ask-pass SSH:认证密码，回车手动输入密码 -c CONNECTION #--connection=CONNECTION：指定连接方式，可用选项paramiko,ssh,local -f NUM #--forks=NUM：并发线程数，默认是5个线程 --list-hosts #列出符合条件的主机列表，不执行任何命令 -v #--verbose:输出更详细的执行过程信息 -vvv #可得到执行过程所有信息 -i PATH #--inventory(清单,即主机列表文件路径)=PATH:指定inventory(清单)信息，默认路径是/etc/ansible/hosts --private-key=PRIVATE_KEY_FILE #指定密钥文件 -M DIRECTORY #--module-path=DIRECTORY:指定模块存放路径，默认/usr/share/ansible/,也可通过ANSIBEL_LIBRARY设定默认路径 -K #--ask-sudo-pass sudo:用户的密码（--sudo时使用） -o #--one-line:标准输出至一行 -s #--sudo:相当于linux系统下的sudo命令 -t DIRECTORY #--tree=DIRECTORY:输出信息至DIRECTORY目录下，结果文件以远程主机命名 -T SECONDS #--timeout=SECONDS：指定连接远程主机的最大超时，单位是秒 -B NUM #--background=NUM:后台执行命令，超过NUM秒后中止正在执行的任务 -P NUM #--poll=NUM:定期返回后台任务进度 -l SUBSET #--limit=SUBSET：指定运行主机 -l ~REGEX #--limit=~REGEX:指定运行主机（正则）
三、Ansible的帮助文档ansible-doc
3.1 命令用法
ansible-doc [options] [module...]
3.2 options选项
--version #显示工具版本号 -h #显示该help说明 -M MODULE_PATH #--module-path=MODULE_PATH指定ansible模块的默认加载目录 -l #--list:列出所有可用模块 -s #--sinppet:只显示playbook说明的代码段 -v #等同于--version，显示工具版本号
例如：ansible-doc -l #列出所有可用模块
3.3 module选项
例如：ansible-doc yum #查看yum模块的使用说明
四.实例
实例1：测试远端网络设备的ssh服务是否能正常访问
命令：ansible 192.168.62.41 -m ping -U cisco -c local -k
#此命令，各参数解析 #192.168.62.41 #此ip已存在/etc/ansible/hosts文件，并开启了inventory功能(/etc/ansible/ansible.cfg) -m ping #使用ping模块，用于测试远端服务ssh的可登陆性 -U cisco #以用户名cisco登录远端主机 -c local #local指定从本地执行python脚本，默认是在远端执行python脚本，因此采用默认连接方式，远端必须是有python环境的 #因此远端若是网络设备，因为不可能还有python环境，因此都需要指定采用本地连接方式-c local -k #回车，输入ssh密码
实例2：获取远端网络设备的设备配置信息
命令：ansible 192.168.62.41 -c local -m ios_facts -a 'auth_pass=cisco gather_subset=all authorize=yes' -u cisco -k
-c local #使用本地连接，默认是远端链接 -m ios_facts #ios_facts是思科ios的设备信息模块 -a #模块里的参数 -a 'auth_pass=cisco gather_subset=all authorize=yes' auth_pass #enable密码 gather_subset #收集给定子集的范围，如收集所有all;只收集配置信息config;不只收集硬件信息!hardware -u username #登录设备用户名 -k #回车输入设备登录密码