> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xdr-agent/8.0-eol/cortex-xdr-agent-for-windows/use-cortex-xdr-agent-for-windows.md).

# Use Cortex XDR Agent for Windows

The Cortex XDR agent installs in the `C:\Program Files (x86)\Palo Alto Networks\Traps` folder. If you enabled access to the console, the agent console is also accessible from the notification area (system tray).

1. Open the Cortex XDR application.

   The console displays active and inactive features by displaying a ![](/files/WrCLDS756OpT0mb7WTwT) or ![](/files/Hx8CAxgx2ds9KUk1TLGk) to the left of the feature type. Select the **Advanced** tab to display additional tabs along the top of the console. The tabs allow you to navigate to pages that display additional details about security events, protected processes, and updates to the security policy. Usually, an end user will not need to run the Cortex XDR console, but the information can be useful when investigating a security-related event. You can choose to hide the tray icon that launches the console, or prevent its launch altogether.

   Use one of the following methods:

   * Browse to `C:\Program Files\Palo Alto Networks\Traps` and run the CyveraConsole.exe application.
   * If you enabled access to Cortex XDR from the notification area, double-click the Cortex XDR icon (![](/files/luuDSTzYnBqE7KsbatZy)) to launch the agent interface.
2. View status information about the Cortex XDR agent:

   ![](/files/zEpkABDbHgpC0UC1uN7U)

   * **Advanced Endpoint Protection**—Displays the overall protection status of the endpoint as enabled if one or more protection features are enabled, or disabled if no protection features are enabled.
     * **Anti-Exploit Protection**—Indicates whether or not exploit prevention rules are active in the endpoint security policy.
     * **Anti-Malware Protection**—Indicates whether restriction or malware protection modules are enabled in the endpoint security policy.
   * **Version**—Displays the Cortex XDR agent version.
   * **Connection**—Displays the connection status and, if connected, includes the server to which the agent is connected.
   * **Last Check-in**—Displays the local time on the endpoint of the last check-in with the server.
3. Manually connect to the server.

   The Cortex XDR agent periodically communicates with the server to send status information and retrieve the latest security policy. The Cortex XDR agent performs this operation transparently at regular intervals so it is not typically necessary to connect to the server manually. If your Connection status is Not Connected, you can try to manually connect. This option is available if you do not want to wait for the automated communication interval to become active.

   To initiate a manual check-in with the server, **Check In Now** from the home page of the Cortex XDR console. If the agent successfully establishes a connection with the server, the Connection status changes to Connected.
4. Collect Cortex XDR agent logs in a file that can be sent to a support representative for analysis.

   Select **Generate Support File**. Cortex XDR agent aggregates the logs into a compressed file. Save it, and then send the file to your support representative. For remote endpoints, you can also retrieve logs from the Cortex Action Center.
5. View recent security events that occurred on your endpoint.

   ![](/files/hI8DhjRdTQiwhOZQ723S)

   1. Click **Advanced**, if necessary, to display additional actions that you can perform from the Cortex XDR console.
   2. Click **Events**.

      For each event, the Cortex XDR console displays the local **Time** that an event occurred, the name of the **Process** that exhibited malicious behavior, the **Module** that triggered the event, and the mode specified for that type of event (Termination or Notification).
6. System and custom file scans.

   Cortex XDR malware scans on DLLs, executables, and Office files on Windows endpoints can be triggered from the Cortex XDR server, or manually on the endpoint.

* **System Scan**—[Scans](/cortex-xdr-3.x/cortex-xdr-3.x-documentation/investigate-and-respond-to-incidents/investigate-endpoints/scan-an-endpoint-for-malware.md) are initiated from the Cortex XDR sever. You can view the **System Scan** progress in your Cortex XDR agent console. However, you cannot control this scan from the endpoint.

  ```
  ![](/files/PGK5r0Miy2eKkTywZTh4)
  ```

  * **Custom Scan**—You can initiate file scanning on demand on your Windows endpoints and get an immediate verdict from WildFire, before the file is ever executed on the endpoint. This ability is enabled by default in the Cortex XDR agent Malware profile settings.

    To initiate a custom scan on the endpoint:

    1. Right-click a file or folder and select **Scan with Cortex XDR**.

       ![](/files/asJqhSHFk2m0dOnCEhns)

       <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h3>Note</h3><p>You will not see this option if <strong>End-user initiated local scan</strong> is disabled on your endpoint.</p></div>
    2. The Cortex XDR agent console opens and you can see the custom scan in progress and eventually the scan verdict for the file. When a malicious file is detected during the custom scan, the event is reported to Cortex XDR directly and will be visible in the Alerts table as **Detected (Scanned)**. However, it will not appear on the **Events** tab of the Cortex XDR agent console. If the file is unknown to WildFire, the agent applies Local Analysis.

    You can scan up to 100 items simultaneously. An item can be single file or a single folder, regardless of the number of files within the folder (for example, a folder containing more than 100 files is considered one item by Cortex XDR).

    <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h3>Note</h3><p>If you scan an unsupported file type, the Cortex XDR agent console will not show a notification for it, and the file will be considered non-malicious.</p></div>

7. Change the display language for the Cortex XDR console.

   The Cortex XDR console is localized in the following languages: English, German, French, Spanish, Chinese (traditional and simplified), and Japanese.

   1. Click **Advanced**, if necessary, to display additional actions that you can perform from the Cortex XDR console.
   2. Click **Settings**.
   3. Select the display language for Cortex XDR (default is English).
8. Configure proxy communication.

   You can use a proxy server on the endpoint for all communications to and from the endpoint, including the communication between the Cortex XDR agent and Cortex XDR.

   * **Define proxy settings explicitly**—You can define a proxy thorough the operating system **Network & Internet** settings, or using the **`netsh`** command from a command prompt. For example:

     **`netsh winhttp set proxy proxy-server="`*****`<protocol>`*****`=`*****`<proxyserver>`*****`:`*****`<port>`*****`"`**

     where:

     * `<protocol>` is either http (unsecure) or https (secure) depending on which protocol you use for proxy communication.
     * `<proxyserver>` is the IP address or FQDN for your proxy server.
     * `<port>` is the port number used for communication with the proxy server.

     <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><h3>Note</h3><p>You can configure Windows to use an unsecure or secure proxy server or you can specify both.</p></div>

     For example, to use different proxy servers for unsecure and secure proxy communication:

     **`netsh winhttp set proxy proxy-server="http=myproxy:8080;https=sproxy:8181"`**

     You can also specify the same server and same port for both unsecure and secure proxy communication.

     There are three options for this command: You can run the command manually (in a command-prompt as an administrator), you can specify the command in a log-in script, or you can use GPO commands.
   * **Retrieve proxy settings through a proxy auto-config (PAC) file**—Cortex XDR can retrieve automatic proxy settings configured on your endpoint explicitly, in a group policy, or using WPAD. No additional agent settings are required for this use case.

     <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><h3>Warning</h3><p>If the proxy settings on your endpoint are configured via WPAD or a user setup script, when you isolate an endpoint from the network you will also lose connectivity with Cortex XDR server.</p></div>
9. Persistent notification from agent that your machine can’t access the network. Only when the issue is resolved, the notification does not appear.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-xdr-agent/8.0-eol/cortex-xdr-agent-for-windows/use-cortex-xdr-agent-for-windows.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
