< Back

Add-AppLockerPolicyPublisherRule

Fri Jan 10, 2020 8:26 pm

NAME Add-AppLockerPolicyPublisherRule



SYNOPSIS

Adds an AppLocker policy publisher rule to an AppLocker policy document.





SYNTAX

Add-AppLockerPolicyPublisherRule -AppLockerPolicyDocument <XmlDocument> -Publisher <String> -Name <String> [-Id

<String>] [-Description <String>] [-ProductName <String>] [-BinaryName <String>] -MinimumBinaryVersion <String>

-MaximumBinaryVersion <String> [-UserOrGroupSid <String>] [-Action <String>] [-Collection <String>] [-PassThru]

[<CommonParameters>]



Add-AppLockerPolicyPublisherRule -AppLockerPolicyDocument <XmlDocument> -Publisher <String> -Name <String> [-Id

<String>] [-Description <String>] [-ProductName <String>] [-BinaryName <String>] -MaximumBinaryVersion <String>

[-UserOrGroupSid <String>] [-Action <String>] [-Collection <String>] [-PassThru] [<CommonParameters>]



Add-AppLockerPolicyPublisherRule -AppLockerPolicyDocument <XmlDocument> -Publisher <String> -Name <String> [-Id

<String>] [-Description <String>] [-ProductName <String>] [-BinaryName <String>] -ExactBinaryVersion <String>

[-UserOrGroupSid <String>] [-Action <String>] [-Collection <String>] [-PassThru] [<CommonParameters>]



Add-AppLockerPolicyPublisherRule -AppLockerPolicyDocument <XmlDocument> -Publisher <String> -Name <String> [-Id

<String>] [-Description <String>] [-ProductName <String>] [-BinaryName <String>] -MinimumBinaryVersion <String>

[-UserOrGroupSid <String>] [-Action <String>] [-Collection <String>] [-PassThru] [<CommonParameters>]





DESCRIPTION

Adds a publisher rule to an existing AppLocker policy document [XmlDocument]. If not specified, publisher

authorizations are only applied to the 'Exe' rule collection and by default allowed for all users ('S-1-1-0).





PARAMETERS

-AppLockerPolicyDocument <XmlDocument>



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Publisher <String>



Required? true

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Name <String>



Required? true

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Id <String>



Required? false

Position? named

Default value ([System.Guid]::NewGuid().ToString())

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Description <String>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-ProductName <String>



Required? false

Position? named

Default value *

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-BinaryName <String>



Required? false

Position? named

Default value *

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-MinimumBinaryVersion <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ExactBinaryVersion <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-MaximumBinaryVersion <String>



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-UserOrGroupSid <String>



Required? false

Position? named

Default value S-1-1-0

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Action <String>



Required? false

Position? named

Default value Allow

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Collection <String>



Required? false

Position? named

Default value Exe

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-PassThru [<SwitchParameter>]

Returns the created XmlElement object to the pipeline. By default, this cmdlet does not generate any output.



Required? false

Position? named

Default value False

Accept pipeline input? true (ByPropertyName)

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 (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Add-AppLockerPolicyPublisherRule -AppLockerPolicyDocument $appLockerPolicy -Name 'BadApp 1.0.0: BAD.exe'

-Publisher 'O=VIRTUAL ENGINE LIMITED, L=OXFORD, S=GARSINGTON, C=GB'



Adds the 'O=VIRTUAL ENGINE LIMITED, L=OXFORD, S=GARSINGTON, C=GB' publisher rule to the 'Exe' rule collection to

the AppLocker policy [XmlDocument] in the '$appLockerPolicy' variable.











RELATED LINKS