PowerShell Logo Small

Get-ADAuthenticationPolicy



This is the built-in help made by Microsoft for the command 'Get-ADAuthenticationPolicy', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Gets one or more Active Directory Domain Services authentication policies.

SYNTAX


Get-ADAuthenticationPolicy [-AuthType {Negotiate | Basic}] [-Credential <PSCredential>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-Server
<String>] -Filter <String> [<CommonParameters>]
Get-ADAuthenticationPolicy [-Identity] <ADAuthenticationPolicy> [-AuthType {Negotiate | Basic}] [-Credential <PSCredential>] [-Properties <String[]>] [-Server <String>]
[<CommonParameters>]
Get-ADAuthenticationPolicy [-AuthType {Negotiate | Basic}] [-Credential <PSCredential>] [-Properties <String[]>] [-ResultPageSize <Int32>] [-ResultSetSize <Int32>] [-Server
<String>] -LDAPFilter <String> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-ADAuthenticationPolicy cmdlet gets an authentication policy or performs a search to get authentication policies.


The Identity parameter specifies the Active Directory Domain Services authentication policy to get. You can identify an authentication policy by its distinguished name (DN),
GUID or name. You can also use the Identity parameter to specify a variable that contains an authentication policy object, or you can use the pipeline operator to pass an
authentication policy object to the Identity parameter.


You can search for and use multiple authentication policies by specifying the Filter parameter or the LDAPFilter parameter. The Filter parameter uses the Windows PowerShell®
expression language to write query strings for Active Directory Domain Services. Windows PowerShell expression language syntax provides rich type conversion support for
value types received by the Filter parameter. For more information about the Filter parameter syntax, type Get-Help about_ActiveDirectory_Filter. If you have existing LDAP
query strings, you can use the LDAPFilter parameter.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=288129
New-ADAuthenticationPolicy
Remove-ADAuthenticationPolicy
Set-ADAuthenticationPolicy

REMARKS

<

Examples


Example 1: Get an authentication policy

PS C:\> Get-ADAuthenticationPolicy -Identity AuthenticationPolicy01



This command gets an authentication policy object by specifying the object name.




Example 2: Get an authentication policy by using an LDAP filter

PS C:\> Get-ADAuthenticationPolicy -LDAPFilter "(name=AuthenticationPolicy*)" -Server Server01.Contoso.com



This command gets all authentication policies that match the LDAP filter specified by the LDAPFilter parameter.




Example 3: Get an authentication policy by using a filter

PS C:\> Get-ADAuthenticationPolicy -Filter "Name -like 'AuthenticationPolicy*'" -Server Server02.Contoso.com



This command gets all authentication policies that match the filter specified by the Filter parameter.




Example 4: Get all authentication policy objects that match a filter

PS C:\> Get-ADAuthenticationPolicy -Filter * | Format-Table Name, Enforce -AutoSize
Name Enforce
---- -------
AuthenticationPolicy1 False
AuthenticationPolicy2 False



This command gets all the authentication policies available. The output is then passed to the Format-Table cmdlet to display the name of the policy and the value for Enforce
on each policy.




Example 5: Get all properties for an authentication policy

PS C:\> Get-ADAuthenticationPolicy -Identity "AuthenticationPolicy01" -Properties "*"



This command gets all properties of the authentication policy specified by the Identity parameter.