User Tools

Site Tools


adsetup:group_policy_preferences:createuserdrivepreferences

To create a correctly formatted Drives GPP, follow the below guidelines.

User Drive Maps GPP

$XMLItemAttributes = ("clsid","name","status","image","changed","uid","disabled","bypassErrors","userContext","desc","removePolicy","PRIMARYEND","action","thisDrive","allDrives","UserName","path","label","persistent","useLetter","letter","RUNONCE","SUBEND")


$XMLItemAttributes values

clsid - This is the clsid of the GPP Drive Maps item. GPP clsid Reference


name - Name of the GPP item.

status - A field that is updated when the value of the GPP is updated. Can be the same text as name or value.

image - This is the image that is shown in the Group Policy GUI. Image Reference

changed - Date the GPP is set. $DateUni = (Get-Date -Format u).TrimEnd('Z').

uid - Generate GUID. $GUID = ([guid]::NewGuid()).ToString().ToUpper().

disabled - Enabled or Disabled . Icon color is indicating the action taken when pressed. On an enabled GPP it is red and on a disabled GPP is green.

bypassErrors - Sets the Stop processing items in this extension is an error occurs. Value of 1 is unchecked, value of 0 is checked.

userContext Sets the Run in logged-on user's security context (user policy option). Value of 1 is checked, value of 0 is unchecked. Only used in User Registry GPP.

desc Set's the Description text. By default includes the $FirmName and $Date. Useful to add additional notes about what the setting actually controls.

removePolicy - Sets the Remove this item when it is no longer applied. Value of 1 is checked, value of 0 is unchecked. Only works with Replace action.

PRIMARYEND - Internal script header to indicate XML subnode.



action - Identifies the action for the GPP.

Action Value
Create C
Replace R
Update U
Delete D

thisDrive - Values are NOCHANGE, HIDE or SHOW. This configures the visibility of the drive in Windows Explorer.

allDrives - Values are NOCHANGE, HIDE or SHOW. This configures the visibility of all mapped and physical drives in Windows Explorer.

UserName - Microsoft removed the ability to store passwords in GPP and that option is now grayed out.

path - The network path the drive will be mapped to.

label - The name that will appear on the drive in Windows Explorer.

persistent - Checks the Reconnect box to make the drive mapping persistent through workstation reboots. Value of 1 is checked, value of 0 is unchecked.

useLetter - Set the Drive Letter option to Use first available, starting at: or Use. Value of 0 is User first available, starting at: and a value of 1 is Use.

letter - Identifies the letter of the drive to use. Values can be A .. Z.

RUNONCE - Signifies if the GPP should be set to Apply once and do not reapply. Valid values are YES or NO.

SUBEND - Internal script header to indicate XML subnode ending.

Drives GPP Examples

adsetup/group_policy_preferences/createuserdrivepreferences.txt · Last modified: 2017/04/01 03:15 by rob