A script to set or remove disk quotas for protected client computers in System Center Data Protection Manager

System-Center-Team · ‎Feb 15 2019

First published on TECHNET on May 02, 2011

The Set-Quota PowerShell script (attached below) applies or removes disk quotas for protected client computers. It uses the expected data size per client value of the protection group to set the required disk quota for the client computers protected under that protection group.

The script leverages windows FSRM (File Server Resource Manager) which should be installed on the DPM server before scripts can run.

Using the script, the quota can be applied or removed for:

1) All client Protection groups in the DPM Server.

2) A specific protection group.

3) A specific client machine.

Things to note when using the script:

1) Script disables auto grow : Auto grow is a check box setting available in the PG creation flow which enables the client’s replica to grow automatically when data size exceeds allocated replica size. This particular setting will be unchecked if quota script is run for the PG or a client in the PG. It is to make sure that when client’s data grows out of its quota limit, the backups start to fail with Replica volume threshold exceeded.

2) Script should be run when clients are added for protection: The script when executed, applies quota for all the clients for whom protection is configured as of now in DPM. When new clients keep getting added to protection, script should be run to again set quota for them. You can also schedule quota script to run at desired frequency.

3) Ability to set threshold : Script provides ability to set a warning threshold for early indication of anticipatory failures. It is notified with a warning event in Application events with id: 12325 whenever a client’s backup data size crosses the threshold limit.

4) Quota exceeded Indication : When client’s data exceeds the quota limit, an error event is also raised in application event viewer with id: 12325. DPM’s backups also fail with ‘ Replica Disk threshold exceeded ’ alert in DPM. Client UI also shows the backup related error .

5) Logging : The script logs its activity in log file: [DPM Install Path]\DPM\Temp\Set-Quota.log.

6) Usage : From DPM PowerShell command, run get-help Set-Quota.ps1 . The help works like any other command let. See some details .

Details for deployment/testing:

1) Copy Set-Quota.ps1, QuotaExceededNotification.txt, QuotaThresholdNotification.txt and Set-Quota-Scheduler.bat from the zip folder to DPM bin folder.

2) To run script manually, open DPM management shell and run Set-Quota.ps1. (get-help Set-Quota.ps1 for help)

3) To schedule the script, create a new scheduled task with Set-Quota-Scheduler.bat as the target.

Appendix:

Expected data size setting per Client:

Enabling FSRM in DPM Server:

From Server manager wizard, do the following 2 steps

1. Add 'File Services ' Role if not already added:

2. Go to File Services Role and in 'Add Role Services' check mark 'File Server Resource Manager' and chose install as shown below:

Disk Quota Threshold Exceeded Warning Event:

Disk quota exceeded error event:

Quota exceeded failure in DPM:

Backup Error in Client:

Set-Quota help:

To see the examples, type: "get-help C:\Program Files\Microsoft DPM\DPM\bin\Set-Quota.ps1 -examples".

For more information, type: "get-help C:\Program Files\Microsoft DPM\DPM\bin\Set-Quota.ps1 -detailed".

For technical information, type: "get-help C:\Program Files\Microsoft DPM\DPM\bin\Set-Quota.ps1 -full".

You can download the script here:

Quota.zip

Venkata Ramana Murthy | SDET II, SC Data Protection Manager

Products (52)

Special Topics (29)

Video Hub (447)

Most Active Hubs

Most Active Hubs

Video Hub

A script to set or remove disk quotas for protected client computers in System Center Data Protection Manager

Appendix: