New-AppVentiXGroupPolicyUserSetting
Creates a new AppVentiX Group Policy user setting XML file from ADMX/ADML policy definitions.
Syntax
# Parameter Set: AppVentiXParamsFile
New-AppVentiXGroupPolicyUserSetting
-FriendlyName <String>
[-Description <String>]
[-ExecutionOrder <Int32>]
[-ProcessAtLogin]
[-ProcessAtRefresh]
[-ProcessAtReconnectAndUnlock]
[-MachineGroupFriendlyName <String>]
-AdmxFilePath <String>
[-AdmlFilePath <String>]
[-AdmlLanguage <String>]
-PolicyInputObject <PSCustomObject[]>
[<CommonParameters>]
# Parameter Set: AppVentiXParamsContent
New-AppVentiXGroupPolicyUserSetting
-FriendlyName <String>
[-Description <String>]
[-ExecutionOrder <Int32>]
[-ProcessAtLogin]
[-ProcessAtRefresh]
[-ProcessAtReconnectAndUnlock]
[-MachineGroupFriendlyName <String>]
-AdmxContent <String>
-AdmxFileName <String>
[-AdmlContent <String>]
[-AdmlFileName <String>]
[-AdmlLanguage <String>]
-PolicyInputObject <PSCustomObject[]>
[<CommonParameters>]
# Parameter Set: InputObject
New-AppVentiXGroupPolicyUserSetting
-InputObject <PSCustomObject>
[<CommonParameters>]
Description
The New-AppVentiXGroupPolicyUserSetting function creates a new AppVentiX user setting XML file that applies Group Policy settings based on ADMX/ADML policy template definitions. ADMX and ADML content can be provided either as file paths or as inline string content.
This function has the alias New-AppVentiXGroupPolicy.
Parameters
-FriendlyName
The display name for the Group Policy user setting.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
An optional description for the Group Policy user setting.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExecutionOrder
The execution order for this user setting relative to others.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProcessAtLogin
When specified, the Group Policy setting is processed at user login.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProcessAtRefresh
When specified, the Group Policy setting is processed at refresh.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProcessAtReconnectAndUnlock
When specified, the Group Policy setting is processed at reconnect and unlock.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MachineGroupFriendlyName
The friendly name of the machine group to associate with this user setting.
| Type: | String |
| Position: | Named |
| Default value: | All Machine Groups |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmxFilePath
The full path to the ADMX template file. Used with the AppVentiXParamsFile parameter set.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmlFilePath
The full path to the ADML language file. Optional when using the AppVentiXParamsFile parameter set.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmxContent
The raw XML content of the ADMX template. Used with the AppVentiXParamsContent parameter set.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmxFileName
The filename to associate with the ADMX content when using inline content.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmlContent
The raw XML content of the ADML language file. Optional when using the AppVentiXParamsContent parameter set.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmlFileName
The filename to associate with the ADML content when using inline content.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdmlLanguage
The language code for the ADML file (e.g., ‘en-US’).
| Type: | String |
| Position: | Named |
| Default value: | en-US |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PolicyInputObject
An array of PSCustomObject items representing the individual policy settings to apply. Each object should describe a policy name and its configured value.
| Type: | PSCustomObject[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
A PSCustomObject containing all Group Policy properties including embedded ADMX/ADML content. Used when piping output from Get-IvantiWCPolicy or similar functions.
| Type: | PSCustomObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Examples
Example 1: Create a Group Policy setting from ADMX files
$policies = Get-AdmxPolicySetting -Path "C:\ADMX\MyApp.admx" | Where-Object { $_.PolicyName -eq "DisableFeatureX" }
New-AppVentiXGroupPolicyUserSetting -FriendlyName "Disable Feature X" -AdmxFilePath "C:\ADMX\MyApp.admx" -AdmlFilePath "C:\ADMX\en-US\MyApp.adml" -PolicyInputObject $policies -ProcessAtLogin
Creates a Group Policy user setting from ADMX and ADML files.
Notes
- Requires a valid AppVentiX license
- This function has the alias
New-AppVentiXGroupPolicy - ADMX and ADML content is embedded directly into the AppVentiX user setting XML