---
title: "system.opc.setServerEnabled"
description: "Enables or disables an OPC server connection."
---

# system.opc.setServerEnabled

> Enables or disables an OPC server connection.

This function is used in **Python Scripting**.

## Description
## Client Permission Restrictions
[Permission Type](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties): OPC Server Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax
`system.opc.setServerEnabled(serverName, enabled)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `serverName` | The name of an OPC server connection.
 Boolean| `enabled` | The new state the connection should be set to: true to enable the connection, false to disable.

### Returns

Nothing

### Scope

Gateway, Vision Client, Perspective Session

## Code Examples
```python title="Code Snippet"
# The following will iterate through all configured OPC servers, and check if they are enabled or disabled.
# If an OPC server is disabled, the code will enable it with a call to setServerEnabled.
# This code interacts in the Client scope, so it should be placed on a component, such as a Button.
 
# Retrieve a list of all servers in the Gateway.
allServers = system.opc.getServers(True)
 
# Initialize a message. The empty string is initially used so that the value may be checked later.
message = ""
 
# Iterate through each server.
for server in allServers:
    # For each server, call isServerEnabled. Uses Python's "not" operator to check if a false value is returned.
    if not system.opc.isServerEnabled(server):
        # If disabled, then enable the server.
        system.opc.setServerEnabled(server, True)
        # Append details about the state change we made to the message variable.
        message += "%s \n" % (server)
 
# Check to see if any changes were made. If the length (len()) of the message is less than 1 character, then a change wasn't made.
if len(message) < 1:
    # Notify the user that the code did not make any changes.
    system.vision.showMessage("No servers were modified")
else:  
    # Otherwise, let the user know which servers we enabled.
    system.vision.showMessage("The following servers were modified:\n" + message)
```