< Back
Set-AppLockerPolicy
Post
NAME Set-AppLockerPolicy
SYNOPSIS
Sets the AppLocker policy for the specified GPO.
SYNTAX
Set-AppLockerPolicy [-XmlPolicy] <String> [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <System.String>] [-Ldap <String>] [-Merge] [<CommonParameters>]
Set-AppLockerPolicy [-PolicyObject] <AppLockerPolicy> [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <System.String>] [-Ldap <String>] [-Merge] [<CommonParameters>]
DESCRIPTION
The Set-AppLockerPolicy cmdlet sets the specified GPO to contain the specified AppLocker policy. If no Lightweight Directory Access Protocol
(LDAP) is specified, then the default is the local GPO.
The input values for the AppLocker policy can be an AppLockerPolicy object or an XML-formatted file that contains the AppLocker policy.
PARAMETERS
-InformationAction [<System.Management.Automation.ActionPreference>]
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-InformationVariable [<System.String>]
Specifies a variable in which to store an information event message.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Ldap [<String>]
Specifies the LDAP path of the GPO. It must specify a unique GPO. If this parameter is not specified, then the local AppLocker policy is set.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Merge [<SwitchParameter>]
Merges the rules in the specified AppLocker policy with the AppLocker rules in the target GPO specified in the LDAP path. The merging of
policies will remove rules with duplicate rule IDs, and the enforcement setting specified by the AppLocker policy in the target GPO will be
preserved. If the Merge parameter is not specified, then the new policy will overwrite the existing policy.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PolicyObject <AppLockerPolicy>
Specifies the AppLockerPolicy object that contains the AppLocker policy. Can be obtained from the Get-AppLockerPolicy and the
New-AppLockerPolicy cmdlets.
Required? true
Position? 1
Default value none
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-XmlPolicy <String>
Specifies the path where the XML-formatted file that contains the AppLocker policy is saved.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Security.ApplicationId.PolicyManagement.PolicyModel.AppLockerPolicy
AppLockerPolicy
System.String
OUTPUTS
None
EXAMPLE 1
PS C:\\> Set-AppLockerPolicy -XMLPolicy C:\\Policy.xml
This example sets the local AppLocker policy to the policy specified in C:\\Policy.xml.
EXAMPLE 2
PS C:\\> Set-AppLockerPolicy -XMLPolicy C:\\Policy.xml -LDAP
"LDAP://DC13.Contoso.com/CN={31B2F340-016D-11D2-945F-00C04FB984F9},CN=Policies,CN=System,DC=Contoso,DC=com"
This example sets the GPO specified in the LDAP path to contain the AppLocker policy that is specified in C:\\Policy.xml.
EXAMPLE 3
PS C:\\> Get-AppLockerPolicy -Local | Set-AppLockerPolicy -LDAP
"LDAP://DC13.Contoso.com/CN={31B2F340-016D-11D2-945F-00C04FB984F9},CN=Policies,CN=System,DC=Contoso,DC=com" -Merge
This example gets the local AppLocker policy, and then merges the policy with the existing AppLocker policy in the GPO specified in the LDAP path.
For more information on how two policies are merged, see the Merge parameter description.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?linkid=287251
Get-AppLockerFileInformation
Get-AppLockerPolicy
New-AppLockerPolicy
Test-AppLockerPolicy
SYNOPSIS
Sets the AppLocker policy for the specified GPO.
SYNTAX
Set-AppLockerPolicy [-XmlPolicy] <String> [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <System.String>] [-Ldap <String>] [-Merge] [<CommonParameters>]
Set-AppLockerPolicy [-PolicyObject] <AppLockerPolicy> [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}]
[-InformationVariable <System.String>] [-Ldap <String>] [-Merge] [<CommonParameters>]
DESCRIPTION
The Set-AppLockerPolicy cmdlet sets the specified GPO to contain the specified AppLocker policy. If no Lightweight Directory Access Protocol
(LDAP) is specified, then the default is the local GPO.
The input values for the AppLocker policy can be an AppLockerPolicy object or an XML-formatted file that contains the AppLocker policy.
PARAMETERS
-InformationAction [<System.Management.Automation.ActionPreference>]
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-InformationVariable [<System.String>]
Specifies a variable in which to store an information event message.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Ldap [<String>]
Specifies the LDAP path of the GPO. It must specify a unique GPO. If this parameter is not specified, then the local AppLocker policy is set.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Merge [<SwitchParameter>]
Merges the rules in the specified AppLocker policy with the AppLocker rules in the target GPO specified in the LDAP path. The merging of
policies will remove rules with duplicate rule IDs, and the enforcement setting specified by the AppLocker policy in the target GPO will be
preserved. If the Merge parameter is not specified, then the new policy will overwrite the existing policy.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-PolicyObject <AppLockerPolicy>
Specifies the AppLockerPolicy object that contains the AppLocker policy. Can be obtained from the Get-AppLockerPolicy and the
New-AppLockerPolicy cmdlets.
Required? true
Position? 1
Default value none
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-XmlPolicy <String>
Specifies the path where the XML-formatted file that contains the AppLocker policy is saved.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
Microsoft.Security.ApplicationId.PolicyManagement.PolicyModel.AppLockerPolicy
AppLockerPolicy
System.String
OUTPUTS
None
EXAMPLE 1
PS C:\\> Set-AppLockerPolicy -XMLPolicy C:\\Policy.xml
This example sets the local AppLocker policy to the policy specified in C:\\Policy.xml.
EXAMPLE 2
PS C:\\> Set-AppLockerPolicy -XMLPolicy C:\\Policy.xml -LDAP
"LDAP://DC13.Contoso.com/CN={31B2F340-016D-11D2-945F-00C04FB984F9},CN=Policies,CN=System,DC=Contoso,DC=com"
This example sets the GPO specified in the LDAP path to contain the AppLocker policy that is specified in C:\\Policy.xml.
EXAMPLE 3
PS C:\\> Get-AppLockerPolicy -Local | Set-AppLockerPolicy -LDAP
"LDAP://DC13.Contoso.com/CN={31B2F340-016D-11D2-945F-00C04FB984F9},CN=Policies,CN=System,DC=Contoso,DC=com" -Merge
This example gets the local AppLocker policy, and then merges the policy with the existing AppLocker policy in the GPO specified in the LDAP path.
For more information on how two policies are merged, see the Merge parameter description.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?linkid=287251
Get-AppLockerFileInformation
Get-AppLockerPolicy
New-AppLockerPolicy
Test-AppLockerPolicy