# SaveQVSSettings Method

## Overloads

| [SaveQVSSettings(QVSSettings)](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.Services.V11.IQMS.SaveQVSSettings.htm#PIX_Services_V11_IQMS_SaveQVSSettings_PIX_QMSAPI_DataObjects_QVSSettings_) |  | Saves the specified QlikView Server settings. |
| --- | --- | --- |

[](https://help.qlik.com/en-US/qlikview-developer/Subsystems/QMSAPIref/Content/PIX.Services.V11.IQMS.SaveQVSSettings.htm) [](https://help.qlik.com/en-US/qlikview-developer/Subsystems/QMSAPIref/Content/PIX.Services.V11.IQMS.SaveQVSSettings.htm)

## SaveQVSSettings(QVSSettings)

Saves the specified QlikView Server settings.

### Declaration

```

          void SaveQVSSettings(QVSSettings qvsSettings)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [QVSSettings](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.htm) | qvsSettings | The QlikView Server settings to save. |

### Remarks

##### implementnotes

The [QVSID](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.QVSID.htm#PIX_QMSAPI_DataObjects_QVSSettings_QVSID) property of `qvsSettings` must contain a valid QlikView Server ID.

Only the settings specified by the [Scope](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.Scope.htm#PIX_QMSAPI_DataObjects_QVSSettings_Scope) property will be saved. None of the properties of `qvsSettings` corresponding to the specified scope can be null.

All settings except [General](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettingsScope.htm#PIX_QMSAPI_DataObjects_QVSSettingsScope_General) and [Distribution](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettingsScope.htm#PIX_QMSAPI_DataObjects_QVSSettingsScope_Distribution) requires that the QlikView Management Service is able to communicate with the QlikView Server.

If the settings are saved with [Scope](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.Scope.htm#PIX_QMSAPI_DataObjects_QVSSettings_Scope) set to [Cluster](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettingsScope.htm#PIX_QMSAPI_DataObjects_QVSSettingsScope_Cluster) and any of the specified cluster [Members](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.QVSCluster.Members.htm#PIX_QMSAPI_DataObjects_QVSSettings_QVSCluster_Members) have a license with a different serial number than the main QlikView Server (first cluster member in the list), the correct license [ControlNumber](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.QVSCluster.QVSClusterLicense.ControlNumber.htm#PIX_QMSAPI_DataObjects_QVSSettings_QVSCluster_QVSClusterLicense_ControlNumber) must be supplied.

##### security

Requires membership of local groups *QlikView Management API* and *QlikView Administrator*.

### Examples

The following code example uses the QMS API to retrieve a registered QlikView Server and its logging settings. It changes the log folder and then saves the logging settings. If everything goes well, it prints the original logging folder and then a message when it's done. If anything goes wrong, it prints an error message.

The service key injection is assumed to be handled behind the scenes. For an example of how to inject the service key, see Samples.

```
using System;
using System.Collections.Generic;
using QMSAPI;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            // create a QMS API client
            IQMS apiClient = new QMSClient();

            //retrieve a time limited service key
            ServiceKeyClientMessageInspector.ServiceKey = apiClient.GetTimeLimitedServiceKey();

            // get a list of QVS services
            List<ServiceInfo> qvsServices = apiClient.GetServices(ServiceTypes.QlikViewServer);
            if (qvsServices.Count > 0)
            {
                // retrieve logging settings for the first QVS in the list
                QVSSettings qvsSettings = apiClient.GetQVSSettings(qvsServices[0].ID, QVSSettingsScope.Logging);
                Console.WriteLine("QVS log folder before change: " + qvsSettings.Logging.Folder);
                // change log folder
                qvsSettings.Logging.Folder = @"\\myshare\logs";
                // save settings
                apiClient.SaveQVSSettings(qvsSettings);
                Console.WriteLine("Settings saved. Log folder changed.");
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("An exception occurred: " + ex.Message);
        }
        // wait for user to press any key
        Console.ReadKey();
    }
}
```

### See Also

[QVSSettings](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.QVSSettings.htm)

[GetQVSSettings(Guid, QVSSettingsScope)](https://help.qlik.com/en-US/qlikview-developer/May2024/Subsystems/QMSAPIref/Content/PIX.Services.V11.IQMS.GetQVSSettings.htm#PIX_Services_V11_IQMS_GetQVSSettings_System_Guid_PIX_QMSAPI_DataObjects_QVSSettingsScope_)