deploy_action.py -husage: deploy_action.py [-h] [-u USERNAME] [-p PASSWORD]
[--session_id SESSION_ID] [--host HOST] [--port PORT]
[-l LOGLEVEL] [--debugformat] [--debug_method_locals]
[--record_all_requests] [--stats_loop_enabled]
[--http_auth_retry]
[--http_retry_count HTTP_RETRY_COUNT]
[--pytan_user_config PYTAN_USER_CONFIG]
[--force_server_version FORCE_SERVER_VERSION] [--run]
[--no-results | --results] [-k PACKAGE]
[-f ACTION_FILTERS] [-o ACTION_OPTIONS]
[--start_seconds_from_now START_SECONDS_FROM_NOW]
[--expire_seconds EXPIRE_SECONDS] [--package-help]
[--filters-help] [--options-help] [--file REPORT_FILE]
[--dir REPORT_DIR]
Deploy an action and save the results as a report format
optional arguments:
-h, --help show this help message and exit
Handler Authentication:
-u USERNAME, --username USERNAME
Name of user (default: None)
-p PASSWORD, --password PASSWORD
Password of user (default: None)
--session_id SESSION_ID
Session ID to authenticate with instead of
username/password (default: None)
--host HOST Hostname/ip of SOAP Server (default: None)
--port PORT Port to use when connecting to SOAP Server (default:
443)
Handler Options:
-l LOGLEVEL, --loglevel LOGLEVEL
Logging level to use, increase for more verbosity
(default: 0)
--debugformat Enable debug format for logging (default: False)
--debug_method_locals
Enable debug logging for each methods local variables
(default: False)
--record_all_requests
Record all requests in
handler.session.ALL_REQUESTS_RESPONSES (default:
False)
--stats_loop_enabled Enable the statistics loop (default: False)
--http_auth_retry Disable retry on HTTP authentication failures
(default: True)
--http_retry_count HTTP_RETRY_COUNT
Retry count for HTTP failures/invalid responses
(default: 5)
--pytan_user_config PYTAN_USER_CONFIG
PyTan User Config file to use for PyTan arguments
(defaults to: ~/.pytan_config.json) (default: )
--force_server_version FORCE_SERVER_VERSION
Force PyTan to consider the server version as this,
instead of relying on the server version derived from
the server info page. (default: )
Deploy Action Options:
--run Run the deploy action, if not supplied the deploy
action will only ask the question that matches
--filter and save the results to csv file for
verification (default: False)
--no-results Do not get the results after starting the deploy
action
--results Get the results after starting the deploy action
(default) (default: True)
-k PACKAGE, --package PACKAGE
Package to deploy action with, optionally describe
parameters, pass --package-help to get a full
description (default: )
-f ACTION_FILTERS, --filter ACTION_FILTERS
Filter to deploy action against; pass --filters-helpto
get a full description (default: [])
-o ACTION_OPTIONS, --option ACTION_OPTIONS
Options for deploy action filter; pass --options-help
to get a full description (default: [])
--start_seconds_from_now START_SECONDS_FROM_NOW
Start the action N seconds from now (default: None)
--expire_seconds EXPIRE_SECONDS
Expire the action N seconds after it starts, if not
supplied the packages own expire_seconds will be used
(default: None)
--package-help Get the full help for package string (default: False)
--filters-help Get the full help for filters strings (default: False)
--options-help Get the full help for options strings (default: False)
Report File Options:
--file REPORT_FILE File to save report to (will be automatically
generated if not supplied) (default: None)
--dir REPORT_DIR Directory to save report to (current directory will be
used if not supplied) (default: None)
Validation Test: exitcode
Validation Test: noerror
bin/deploy_action.py -u Administrator -p 'Tanium2015!' --host 10.0.1.240 --port 443 --loglevel 1 --package-helpPyTan v2.1.6 Handler for Session to 10.0.1.240:443, Authenticated: True, Platform Version: 6.5.314.4301
++ Deploying action:
{
"action_filters": [],
"action_options": [],
"expire_seconds": null,
"filters_help": false,
"get_results": true,
"options_help": false,
"package": "",
"package_help": true,
"report_dir": null,
"report_file": null,
"run": false,
"start_seconds_from_now": null
}
Error occurred:
Package Help
============
Supplying package defines what package will be deployed as part of the
action.
A package string is a human string that describes, at a minimum, a
package. It can also optionally define a selector for the package,
and/or parameters for the package. A package must be provided as a string.
Examples for package
---------------------------------
Supplying a package:
'Distribute Tanium Standard Utilities'
Supplying a package by id:
'id:1'
Supplying a package by hash:
'hash:123456789'
Supplying a package by name:
'name:Distribute Tanium Standard Utilities'
Package Parameters
------------------
Supplying parameters to a package can control the arguments
that are supplied to a package, if that package takes any arguments.
Package parameters must be surrounded with curly braces '{}',
and must have a key and value specified that is separated by
an equals '='. Multiple parameters must be seperated by
a comma ','. The key should match up to a valid parameter key
for the package in question.
If a parameter is supplied and the package doesn't have a
corresponding key name, it will be ignored. If the package has
parameters and a parameter is NOT supplied then an exception
will be raised, printing out the JSON of the missing paramater
for the package in question.
Examples for package with parameters
------------------------------------
Supplying a package with a single parameter '$1':
'Package With Params{$1=value1}'
Supplying a package with two parameters, '$1' and '$2':
'Package With Params{$1=value1,$2=value2}'
Traceback (most recent call last):
File "/Users/jolsen/gh/pytan/lib/pytan/binsupport.py", line 2687, in process_deploy_action_args
response = handler.deploy_action(**obj_grp_args)
File "/Users/jolsen/gh/pytan/lib/pytan/handler.py", line 972, in deploy_action
pytan.utils.check_for_help(kwargs=kwargs)
File "/Users/jolsen/gh/pytan/lib/pytan/utils.py", line 2082, in check_for_help
raise pytan.exceptions.PytanHelp(help_out)
PytanHelp:
Package Help
============
Supplying package defines what package will be deployed as part of the
action.
A package string is a human string that describes, at a minimum, a
package. It can also optionally define a selector for the package,
and/or parameters for the package. A package must be provided as a string.
Examples for package
---------------------------------
Supplying a package:
'Distribute Tanium Standard Utilities'
Supplying a package by id:
'id:1'
Supplying a package by hash:
'hash:123456789'
Supplying a package by name:
'name:Distribute Tanium Standard Utilities'
Package Parameters
------------------
Supplying parameters to a package can control the arguments
that are supplied to a package, if that package takes any arguments.
Package parameters must be surrounded with curly braces '{}',
and must have a key and value specified that is separated by
an equals '='. Multiple parameters must be seperated by
a comma ','. The key should match up to a valid parameter key
for the package in question.
If a parameter is supplied and the package doesn't have a
corresponding key name, it will be ignored. If the package has
parameters and a parameter is NOT supplied then an exception
will be raised, printing out the JSON of the missing paramater
for the package in question.
Examples for package with parameters
------------------------------------
Supplying a package with a single parameter '$1':
'Package With Params{$1=value1}'
Supplying a package with two parameters, '$1' and '$2':
'Package With Params{$1=value1,$2=value2}'
bin/deploy_action.py -u Administrator -p 'Tanium2015!' --host 10.0.1.240 --port 443 --loglevel 1 --filters-helpPyTan v2.1.6 Handler for Session to 10.0.1.240:443, Authenticated: True, Platform Version: 6.5.314.4301
++ Deploying action:
{
"action_filters": [],
"action_options": [],
"expire_seconds": null,
"filters_help": true,
"get_results": true,
"options_help": false,
"package": "",
"package_help": false,
"report_dir": null,
"report_file": null,
"run": false,
"start_seconds_from_now": null
}
Error occurred:
Filters Help
============
Filters are used generously throughout pytan. When used as part of a
sensor string, they control what data is shown for the columns that
the sensor returns. When filters are used for whole question filters,
they control what rows will be returned. They are used by Groups to
define group membership, deploy actions to determine which machines
should have the action deployed to it, and more.
A filter string is a human string that describes, a sensor followed
by ', that FILTER:VALUE', where FILTER is a valid filter string,
and VALUE is the string that you want FILTER to match on.
Valid Filters
-------------
'<'
Help: Filter for less than VALUE
Example: "Sensor1, that <:VALUE"
'less'
Help: Filter for less than VALUE
Example: "Sensor1, that less:VALUE"
'lt'
Help: Filter for less than VALUE
Example: "Sensor1, that lt:VALUE"
'less than'
Help: Filter for less than VALUE
Example: "Sensor1, that less than:VALUE"
'!<'
Help: Filter for not less than VALUE
Example: "Sensor1, that !<:VALUE"
'notless'
Help: Filter for not less than VALUE
Example: "Sensor1, that notless:VALUE"
'not less'
Help: Filter for not less than VALUE
Example: "Sensor1, that not less:VALUE"
'not less than'
Help: Filter for not less than VALUE
Example: "Sensor1, that not less than:VALUE"
'<='
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that <=:VALUE"
'less equal'
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that less equal:VALUE"
'lessequal'
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that lessequal:VALUE"
'le'
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that le:VALUE"
'!<='
Help: Filter for not less than or equal to VALUE
Example: "Sensor1, that !<=:VALUE"
'not less equal'
Help: Filter for not less than or equal to VALUE
Example: "Sensor1, that not less equal:VALUE"
'not lessequal'
Help: Filter for not less than or equal to VALUE
Example: "Sensor1, that not lessequal:VALUE"
'>'
Help: Filter for greater than VALUE
Example: "Sensor1, that >:VALUE"
'greater'
Help: Filter for greater than VALUE
Example: "Sensor1, that greater:VALUE"
'gt'
Help: Filter for greater than VALUE
Example: "Sensor1, that gt:VALUE"
'greater than'
Help: Filter for greater than VALUE
Example: "Sensor1, that greater than:VALUE"
'!>'
Help: Filter for not greater than VALUE
Example: "Sensor1, that !>:VALUE"
'not greater'
Help: Filter for not greater than VALUE
Example: "Sensor1, that not greater:VALUE"
'notgreater'
Help: Filter for not greater than VALUE
Example: "Sensor1, that notgreater:VALUE"
'not greater than'
Help: Filter for not greater than VALUE
Example: "Sensor1, that not greater than:VALUE"
'=>'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that =>:VALUE"
'greater equal'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that greater equal:VALUE"
'greaterequal'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that greaterequal:VALUE"
'ge'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that ge:VALUE"
'!=>'
Help: Filter for not greater than VALUE
Example: "Sensor1, that !=>:VALUE"
'not greater equal'
Help: Filter for not greater than VALUE
Example: "Sensor1, that not greater equal:VALUE"
'notgreaterequal'
Help: Filter for not greater than VALUE
Example: "Sensor1, that notgreaterequal:VALUE"
'='
Help: Filter for equals to VALUE
Example: "Sensor1, that =:VALUE"
'equal'
Help: Filter for equals to VALUE
Example: "Sensor1, that equal:VALUE"
'equals'
Help: Filter for equals to VALUE
Example: "Sensor1, that equals:VALUE"
'eq'
Help: Filter for equals to VALUE
Example: "Sensor1, that eq:VALUE"
'!='
Help: Filter for not equals to VALUE
Example: "Sensor1, that !=:VALUE"
'not equal'
Help: Filter for not equals to VALUE
Example: "Sensor1, that not equal:VALUE"
'notequal'
Help: Filter for not equals to VALUE
Example: "Sensor1, that notequal:VALUE"
'not equals'
Help: Filter for not equals to VALUE
Example: "Sensor1, that not equals:VALUE"
'notequals'
Help: Filter for not equals to VALUE
Example: "Sensor1, that notequals:VALUE"
'ne'
Help: Filter for not equals to VALUE
Example: "Sensor1, that ne:VALUE"
'contains'
Help: Filter for contains VALUE (adds .* before and after VALUE)
Example: "Sensor1, that contains:VALUE"
'does not contain'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that does not contain:VALUE"
'doesnotcontain'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that doesnotcontain:VALUE"
'not contains'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that not contains:VALUE"
'notcontains'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that notcontains:VALUE"
'starts with'
Help: Filter for starts with VALUE (adds .* after VALUE)
Example: "Sensor1, that starts with:VALUE"
'startswith'
Help: Filter for starts with VALUE (adds .* after VALUE)
Example: "Sensor1, that startswith:VALUE"
'does not start with'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that does not start with:VALUE"
'doesnotstartwith'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that doesnotstartwith:VALUE"
'not starts with'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that not starts with:VALUE"
'notstartswith'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that notstartswith:VALUE"
'ends with'
Help: Filter for ends with VALUE (adds .* before VALUE)
Example: "Sensor1, that ends with:VALUE"
'endswith'
Help: Filter for ends with VALUE (adds .* before VALUE)
Example: "Sensor1, that endswith:VALUE"
'does not end with'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that does not end with:VALUE"
'doesnotendwith'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that doesnotendwith:VALUE"
'not ends with'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that not ends with:VALUE"
'notstartswith'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that notstartswith:VALUE"
'is not'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that is not:VALUE"
'not regex'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that not regex:VALUE"
'notregex'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that notregex:VALUE"
'not regex match'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that not regex match:VALUE"
'notregexmatch'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that notregexmatch:VALUE"
'nre'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that nre:VALUE"
'is'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that is:VALUE"
'regex'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that regex:VALUE"
'regex match'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that regex match:VALUE"
'regexmatch'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that regexmatch:VALUE"
're'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that re:VALUE"
Traceback (most recent call last):
File "/Users/jolsen/gh/pytan/lib/pytan/binsupport.py", line 2687, in process_deploy_action_args
response = handler.deploy_action(**obj_grp_args)
File "/Users/jolsen/gh/pytan/lib/pytan/handler.py", line 972, in deploy_action
pytan.utils.check_for_help(kwargs=kwargs)
File "/Users/jolsen/gh/pytan/lib/pytan/utils.py", line 2082, in check_for_help
raise pytan.exceptions.PytanHelp(help_out)
PytanHelp:
Filters Help
============
Filters are used generously throughout pytan. When used as part of a
sensor string, they control what data is shown for the columns that
the sensor returns. When filters are used for whole question filters,
they control what rows will be returned. They are used by Groups to
define group membership, deploy actions to determine which machines
should have the action deployed to it, and more.
A filter string is a human string that describes, a sensor followed
by ', that FILTER:VALUE', where FILTER is a valid filter string,
and VALUE is the string that you want FILTER to match on.
Valid Filters
-------------
'<'
Help: Filter for less than VALUE
Example: "Sensor1, that <:VALUE"
'less'
Help: Filter for less than VALUE
Example: "Sensor1, that less:VALUE"
'lt'
Help: Filter for less than VALUE
Example: "Sensor1, that lt:VALUE"
'less than'
Help: Filter for less than VALUE
Example: "Sensor1, that less than:VALUE"
'!<'
Help: Filter for not less than VALUE
Example: "Sensor1, that !<:VALUE"
'notless'
Help: Filter for not less than VALUE
Example: "Sensor1, that notless:VALUE"
'not less'
Help: Filter for not less than VALUE
Example: "Sensor1, that not less:VALUE"
'not less than'
Help: Filter for not less than VALUE
Example: "Sensor1, that not less than:VALUE"
'<='
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that <=:VALUE"
'less equal'
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that less equal:VALUE"
'lessequal'
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that lessequal:VALUE"
'le'
Help: Filter for less than or equal to VALUE
Example: "Sensor1, that le:VALUE"
'!<='
Help: Filter for not less than or equal to VALUE
Example: "Sensor1, that !<=:VALUE"
'not less equal'
Help: Filter for not less than or equal to VALUE
Example: "Sensor1, that not less equal:VALUE"
'not lessequal'
Help: Filter for not less than or equal to VALUE
Example: "Sensor1, that not lessequal:VALUE"
'>'
Help: Filter for greater than VALUE
Example: "Sensor1, that >:VALUE"
'greater'
Help: Filter for greater than VALUE
Example: "Sensor1, that greater:VALUE"
'gt'
Help: Filter for greater than VALUE
Example: "Sensor1, that gt:VALUE"
'greater than'
Help: Filter for greater than VALUE
Example: "Sensor1, that greater than:VALUE"
'!>'
Help: Filter for not greater than VALUE
Example: "Sensor1, that !>:VALUE"
'not greater'
Help: Filter for not greater than VALUE
Example: "Sensor1, that not greater:VALUE"
'notgreater'
Help: Filter for not greater than VALUE
Example: "Sensor1, that notgreater:VALUE"
'not greater than'
Help: Filter for not greater than VALUE
Example: "Sensor1, that not greater than:VALUE"
'=>'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that =>:VALUE"
'greater equal'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that greater equal:VALUE"
'greaterequal'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that greaterequal:VALUE"
'ge'
Help: Filter for greater than or equal to VALUE
Example: "Sensor1, that ge:VALUE"
'!=>'
Help: Filter for not greater than VALUE
Example: "Sensor1, that !=>:VALUE"
'not greater equal'
Help: Filter for not greater than VALUE
Example: "Sensor1, that not greater equal:VALUE"
'notgreaterequal'
Help: Filter for not greater than VALUE
Example: "Sensor1, that notgreaterequal:VALUE"
'='
Help: Filter for equals to VALUE
Example: "Sensor1, that =:VALUE"
'equal'
Help: Filter for equals to VALUE
Example: "Sensor1, that equal:VALUE"
'equals'
Help: Filter for equals to VALUE
Example: "Sensor1, that equals:VALUE"
'eq'
Help: Filter for equals to VALUE
Example: "Sensor1, that eq:VALUE"
'!='
Help: Filter for not equals to VALUE
Example: "Sensor1, that !=:VALUE"
'not equal'
Help: Filter for not equals to VALUE
Example: "Sensor1, that not equal:VALUE"
'notequal'
Help: Filter for not equals to VALUE
Example: "Sensor1, that notequal:VALUE"
'not equals'
Help: Filter for not equals to VALUE
Example: "Sensor1, that not equals:VALUE"
'notequals'
Help: Filter for not equals to VALUE
Example: "Sensor1, that notequals:VALUE"
'ne'
Help: Filter for not equals to VALUE
Example: "Sensor1, that ne:VALUE"
'contains'
Help: Filter for contains VALUE (adds .* before and after VALUE)
Example: "Sensor1, that contains:VALUE"
'does not contain'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that does not contain:VALUE"
'doesnotcontain'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that doesnotcontain:VALUE"
'not contains'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that not contains:VALUE"
'notcontains'
Help: Filter for does not contain VALUE (adds .* before and after VALUE)
Example: "Sensor1, that notcontains:VALUE"
'starts with'
Help: Filter for starts with VALUE (adds .* after VALUE)
Example: "Sensor1, that starts with:VALUE"
'startswith'
Help: Filter for starts with VALUE (adds .* after VALUE)
Example: "Sensor1, that startswith:VALUE"
'does not start with'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that does not start with:VALUE"
'doesnotstartwith'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that doesnotstartwith:VALUE"
'not starts with'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that not starts with:VALUE"
'notstartswith'
Help: Filter for does not start with VALUE (adds .* after VALUE)
Example: "Sensor1, that notstartswith:VALUE"
'ends with'
Help: Filter for ends with VALUE (adds .* before VALUE)
Example: "Sensor1, that ends with:VALUE"
'endswith'
Help: Filter for ends with VALUE (adds .* before VALUE)
Example: "Sensor1, that endswith:VALUE"
'does not end with'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that does not end with:VALUE"
'doesnotendwith'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that doesnotendwith:VALUE"
'not ends with'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that not ends with:VALUE"
'notstartswith'
Help: Filter for does bit end with VALUE (adds .* before VALUE)
Example: "Sensor1, that notstartswith:VALUE"
'is not'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that is not:VALUE"
'not regex'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that not regex:VALUE"
'notregex'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that notregex:VALUE"
'not regex match'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that not regex match:VALUE"
'notregexmatch'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that notregexmatch:VALUE"
'nre'
Help: Filter for non regular expression match for VALUE
Example: "Sensor1, that nre:VALUE"
'is'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that is:VALUE"
'regex'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that regex:VALUE"
'regex match'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that regex match:VALUE"
'regexmatch'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that regexmatch:VALUE"
're'
Help: Filter for regular expression match for VALUE
Example: "Sensor1, that re:VALUE"
bin/deploy_action.py -u Administrator -p 'Tanium2015!' --host 10.0.1.240 --port 443 --loglevel 1 --options-helpPyTan v2.1.6 Handler for Session to 10.0.1.240:443, Authenticated: True, Platform Version: 6.5.314.4301
++ Deploying action:
{
"action_filters": [],
"action_options": [],
"expire_seconds": null,
"filters_help": false,
"get_results": true,
"options_help": true,
"package": "",
"package_help": false,
"report_dir": null,
"report_file": null,
"run": false,
"start_seconds_from_now": null
}
Error occurred:
Options Help
============
Options are used for controlling how filters act. When options are
used as part of a sensor string, they change how the filters
supplied as part of that sensor operate. When options are used for
whole question options, they change how all of the question filters
operate.
When options are supplied for a sensor string, they must be
supplied as ', opt:OPTION' or ', opt:OPTION:VALUE' for options
that require a value.
When options are supplied for question options, they must be
supplied as 'OPTION' or 'OPTION:VALUE' for options that require
a value.
Options can be used on 'filter' or 'group', where 'group' pertains
to group filters or question filters. All 'filter' options are also
applicable to 'group' for question options.
Valid Options
-------------
'ignore_case'
Help: Make the filter do a case insensitive match
Usable on: filter
Example for sensor: "Sensor1, opt:ignore_case"
Example for question: "ignore_case"
'match_case'
Help: Make the filter do a case sensitive match
Usable on: filter
Example for sensor: "Sensor1, opt:match_case"
Example for question: "match_case"
'match_any_value'
Help: Make the filter match any value
Usable on: filter
Example for sensor: "Sensor1, opt:match_any_value"
Example for question: "match_any_value"
'match_all_values'
Help: Make the filter match all values
Usable on: filter
Example for sensor: "Sensor1, opt:match_all_values"
Example for question: "match_all_values"
'max_data_age'
Help: Re-fetch cached values older than N seconds
Usable on: filter
VALUE description and type: seconds, <type 'int'>
Example for sensor: "Sensor1, opt:max_data_age:seconds"
Example for question: "max_data_age:seconds"
'value_type'
Help: Make the filter consider the value type as VALUE_TYPE
Usable on: filter
VALUE description and type: value_type, <type 'str'>
Example for sensor: "Sensor1, opt:value_type:value_type"
Example for question: "value_type:value_type"
'and'
Help: Use 'and' for all of the filters supplied
Usable on: group
Example for sensor: "Sensor1, opt:and"
Example for question: "and"
'or'
Help: Use 'or' for all of the filters supplied
Usable on: group
Example for sensor: "Sensor1, opt:or"
Example for question: "or"
Traceback (most recent call last):
File "/Users/jolsen/gh/pytan/lib/pytan/binsupport.py", line 2687, in process_deploy_action_args
response = handler.deploy_action(**obj_grp_args)
File "/Users/jolsen/gh/pytan/lib/pytan/handler.py", line 972, in deploy_action
pytan.utils.check_for_help(kwargs=kwargs)
File "/Users/jolsen/gh/pytan/lib/pytan/utils.py", line 2082, in check_for_help
raise pytan.exceptions.PytanHelp(help_out)
PytanHelp:
Options Help
============
Options are used for controlling how filters act. When options are
used as part of a sensor string, they change how the filters
supplied as part of that sensor operate. When options are used for
whole question options, they change how all of the question filters
operate.
When options are supplied for a sensor string, they must be
supplied as ', opt:OPTION' or ', opt:OPTION:VALUE' for options
that require a value.
When options are supplied for question options, they must be
supplied as 'OPTION' or 'OPTION:VALUE' for options that require
a value.
Options can be used on 'filter' or 'group', where 'group' pertains
to group filters or question filters. All 'filter' options are also
applicable to 'group' for question options.
Valid Options
-------------
'ignore_case'
Help: Make the filter do a case insensitive match
Usable on: filter
Example for sensor: "Sensor1, opt:ignore_case"
Example for question: "ignore_case"
'match_case'
Help: Make the filter do a case sensitive match
Usable on: filter
Example for sensor: "Sensor1, opt:match_case"
Example for question: "match_case"
'match_any_value'
Help: Make the filter match any value
Usable on: filter
Example for sensor: "Sensor1, opt:match_any_value"
Example for question: "match_any_value"
'match_all_values'
Help: Make the filter match all values
Usable on: filter
Example for sensor: "Sensor1, opt:match_all_values"
Example for question: "match_all_values"
'max_data_age'
Help: Re-fetch cached values older than N seconds
Usable on: filter
VALUE description and type: seconds, <type 'int'>
Example for sensor: "Sensor1, opt:max_data_age:seconds"
Example for question: "max_data_age:seconds"
'value_type'
Help: Make the filter consider the value type as VALUE_TYPE
Usable on: filter
VALUE description and type: value_type, <type 'str'>
Example for sensor: "Sensor1, opt:value_type:value_type"
Example for question: "value_type:value_type"
'and'
Help: Use 'and' for all of the filters supplied
Usable on: group
Example for sensor: "Sensor1, opt:and"
Example for question: "and"
'or'
Help: Use 'or' for all of the filters supplied
Usable on: group
Example for sensor: "Sensor1, opt:or"
Example for question: "or"
bin/deploy_action.py -u Administrator -p 'Tanium2015!' --host 10.0.1.240 --port 443 --loglevel 1 --package "Distribute Tanium Standard Utilities" --file "/tmp/out.csv"PyTan v2.1.6 Handler for Session to 10.0.1.240:443, Authenticated: True, Platform Version: 6.5.314.4301
++ Deploying action:
{
"action_filters": [],
"action_options": [],
"expire_seconds": null,
"filters_help": false,
"get_results": true,
"options_help": false,
"package": "Distribute Tanium Standard Utilities",
"package_help": false,
"report_dir": null,
"report_file": "/tmp/out.csv",
"run": false,
"start_seconds_from_now": null
}
2015-10-02 20:06:52,525 INFO pytan.pollers.QuestionPoller: ID 16108: Reached Threshold of 99% (3 of 3)
Error occurred: 'Run' is not True!!
View and verify the contents of /tmp/VERIFY_BEFORE_DEPLOY_ACTION_out.csv (length: 103 bytes)
Re-run this deploy action with run=True after verifying
Traceback (most recent call last):
File "/Users/jolsen/gh/pytan/lib/pytan/binsupport.py", line 2687, in process_deploy_action_args
response = handler.deploy_action(**obj_grp_args)
File "/Users/jolsen/gh/pytan/lib/pytan/handler.py", line 996, in deploy_action
**clean_kwargs
File "/Users/jolsen/gh/pytan/lib/pytan/handler.py", line 3052, in _deploy_action
raise pytan.exceptions.RunFalse(m(report_path, len(result)))
RunFalse: 'Run' is not True!!
View and verify the contents of /tmp/VERIFY_BEFORE_DEPLOY_ACTION_out.csv (length: 103 bytes)
Re-run this deploy action with run=True after verifying
Computer Name,Online
c1u14-virtual-machine.(none),True
WIN-6U71ED4M23D,True
TPT1.pytanlab.com,True
bin/deploy_action.py -u Administrator -p 'Tanium2015!' --host 10.0.1.240 --port 443 --loglevel 1 --package "Distribute Tanium Standard Utilities" --run --file "/tmp/out.csv"PyTan v2.1.6 Handler for Session to 10.0.1.240:443, Authenticated: True, Platform Version: 6.5.314.4301
++ Deploying action:
{
"action_filters": [],
"action_options": [],
"expire_seconds": null,
"filters_help": false,
"get_results": true,
"options_help": false,
"package": "Distribute Tanium Standard Utilities",
"package_help": false,
"report_dir": null,
"report_file": "/tmp/out.csv",
"run": true,
"start_seconds_from_now": null
}
2015-10-02 20:06:58,046 INFO pytan.pollers.QuestionPoller: ID 16109: Reached Threshold of 99% (3 of 3)
2015-10-02 20:07:28,252 INFO pytan.pollers.ActionPoller: ID 141: Reached Threshold for Seen Count of 100% (3 of 3)
2015-10-02 20:07:28,273 INFO pytan.pollers.ActionPoller: ID 141: Reached Threshold for Finished Count of 100% (3 of 3)
++ Deployed Action 'API Deploy Distribute Tanium Standard Utilities' ID: 141
++ Command used in Action: 'cmd /c cscript install-standard-utils.vbs "Tools\\StdUtils"'
++ Deploy action progress results:
Total failed: 0
Total finished: 3
Total running: 0
Total success: 3
Total unknown: 0
++ Deploy results written to '/tmp/out.csv' with 142 bytes
Validation Test: exitcode
Validation Test: file_exist_contents
Action Statuses,Computer Name
141:Completed.,c1u14-virtual-machine.(none)
141:Completed.,WIN-6U71ED4M23D
141:Completed.,TPT1.pytanlab.com
bin/deploy_action.py -u Administrator -p 'Tanium2015!' --host 10.0.1.240 --port 443 --loglevel 1 --package "Custom Tagging - Add Tags{\$1=new_tag}" --filter "Operating System, that contains:Windows" --run --file "/tmp/out.csv"PyTan v2.1.6 Handler for Session to 10.0.1.240:443, Authenticated: True, Platform Version: 6.5.314.4301
++ Deploying action:
{
"action_filters": [
"Operating System, that contains:Windows"
],
"action_options": [],
"expire_seconds": null,
"filters_help": false,
"get_results": true,
"options_help": false,
"package": "Custom Tagging - Add Tags{$1=new_tag}",
"package_help": false,
"report_dir": null,
"report_file": "/tmp/out.csv",
"run": true,
"start_seconds_from_now": null
}
2015-10-02 20:07:33,809 INFO pytan.pollers.QuestionPoller: ID 16111: Reached Threshold of 99% (3 of 3)
2015-10-02 20:07:53,938 INFO pytan.pollers.ActionPoller: ID 142: Reached Threshold for Seen Count of 100% (2 of 2)
2015-10-02 20:07:53,960 INFO pytan.pollers.ActionPoller: ID 142: Reached Threshold for Finished Count of 100% (2 of 2)
++ Deployed Action 'API Deploy Custom Tagging - Add Tags' ID: 142
++ Command used in Action: 'cmd /c cscript //T:60 add-tags.vbs "new%5ftag"'
++ Deploy action progress results:
Total failed: 0
Total finished: 2
Total running: 0
Total success: 2
Total unknown: 0
++ Deploy results written to '/tmp/out.csv' with 97 bytes
Validation Test: exitcode
Validation Test: file_exist_contents
Action Statuses,Computer Name
142:Completed.,WIN-6U71ED4M23D
142:Completed.,TPT1.pytanlab.com
build_bin_doc v2.1.0, date: Fri Oct 2 16:07:53 2015 EDT, Contact info: Jim Olsen jim.olsen@tanium.com