apm policy agent endpoint-windows-check-registry
apm policy agent endpoint-wapmBpolicyTagentaendpoint-windows-check-registry(1)
NAME
endpoint-windows-check-registry - Manages an Endpoint Windows Check
Registry agent.
MODULE
apm policy agent
SYNTAX
Configure the endpoint-windows-check-registry component within the
policy agent module using the following syntax.
CREATE/MODIFY
create endpoint-windows-check-registry [name]
modify endpoint-windows-check-registry [name]
options:
continuous-check [ true | false ]
app-service [[string] | none]
expression [[string] | none]
edit endpoint-windows-check-registry [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
DISPLAY
list endpoint-windows-check-registry
list endpoint-windows-check-registry [ [ [name] | [glob] | [regex] ] ... ]
show running-config endpoint-windows-check-registry
show running-config endpoint-windows-check-registry [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
partition
show endpoint-windows-check-registry
show endpoint-windows-check-registry [name]
DELETE
delete endpoint-windows-check-registry [name]
DESCRIPTION
You can use the endpoint-windows-check-registry component to create and
manage an agent that collects information about the Windows registry
keys on the client that is attempting to connect.
EXAMPLES
create endpoint-windows-check-registry MyEndpointWCRagent
{"\"HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Internet
Explorer\".\"Version\"=\"5.0.2800.0\"" }
Creates the Endpoint Windows Check Registry agent named
MyEndpointWCRagent that checks the registry on the client for
version 5.0.2800.0 of Internet Explorer in the
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft directory.
create endpoint-windows-check-registry MyEndpointWCRagent
{"\"HKEY_LOCAL_MACHINE64\\SOFTWARE\\Microsoft\\Internet
Explorer\".\"Version\"=\"5.0.2800.0\""
Creates the Endpoint Windows Check Registry agent named
MyEndpointWCRagent that checks the registry on the client for
version 5.0.2800.0 of Internet Explorer in the
HKEY_LOCAL_MACHINE64\SOFTWARE\Microsoft directory.
Note that the registry value HKEY_LOCAL_MACHINE64 is one of the 32
and 64-bit registry keys that you can specify on 64-bit Windows
versions. On 64-bit Windows systems, you can check for registry
keys in either the 64-bit registry or the 32-bit registry. To
specify the registry to check, append a number to the registry
root key name. The following key names are supported:
HKEY_CURRENT_USER
HKEY_CURRENT_USER32
HKEY_CURRENT_USER64
HKEY_LOCAL_MACHINE
HKEY_LOCAL_MACHINE32
HKEY_LOCAL_MACHINE64
HKEY_CLASSES_ROOT
HKEY_CLASSES_ROOT32
HKEY_CLASSES_ROOT64
HKEY_USERS
HKEY_USERS32
HKEY_USERS64 HKEY values specified with a 32 allow you to
check values in the 32-bit view of 64-bit registry. This is the
perspective used by 32-bit applications running with on a 64-bit
operating system.
HKEY values with a 64 appended allow you to check values in the
64-bit view of the registry. This is the perspective used by
native 64-bit applications. When checking values on 32-bit
Windows, the number of bits specified in the registry key name is
ignored.
list endpoint-windows-check-registry
Displays a list of Endpoint Windows Check Registry agents.
delete endpoint-windows-check-registry MyEndpointWCRagent delete
Deletes the Endpoint Windows Check Registry agent named
MyEndpointWCRagent.
OPTIONS
app-service
Specifies the name of the application service to which the object
belongs. The default value is none. Note: If the strict-updates
option is enabled on the application service that owns the object,
you cannot modify or delete the object. Only the application
service can modify or delete the object.
expression
Specifies the expression that you want an Endpoint Windows Check
Registry agent to use to verify the registry entries that are
present on the client in order to allow the access policy to pass.
You can use the following operators: AND, OR, NOT, (and).
If the check is successful, the system returns 1. If the check
fails, the system returns 0. If the expression is incorrect, the
system returns -1.
Important: You must use quotation marks (" ") around key and value
arguments, and in data when the content contains spaces, commas,
slashes, tabs, or other delimiters. If quotation marks exist as
part of a registry path or value name, you must use quotation
marks around those quotation marks.
Tip: The system treats data in the formats "d.d[.d][.d]" or
"d,d[,d][,d]" (where d is a number) as a version number. The
system treats data in the format "mm/dd/yyyy" as a date.
continuous-check
Continuously check the expression, and end the session if the
result changes. The default is false.
[name]
Specifies the name of the an Endpoint Windows Check Registry
agent. This option is required.
partition
Displays the partition within which the component resides.
SEE ALSO
endpoint-check-software, endpoint-linux-check-file, endpoint-linux-
check-process, endpoint-mac-check-file, endpoint-mac-check-process,
endpoint-windows-browser-cache-cleaner, endpoint-windows-check-file,
endpoint-check-machine-cert, endpoint-windows-check-process, endpoint-
windows-group-policy, endpoint-windows-info-os, endpoint-machine-info,
endpoint-windows-protected-workspace
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or
by any means, electronic or mechanical, including photocopying,
recording, or information storage and retrieval systems, for any
purpose other than the purchaser's personal use, without the express
written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2011-2013. All rights reserved.
BIG-IP apm policy3agent0endpoint-windows-check-registry(1)