This is the built-in help made by Microsoft for the command 'New-ADClaimType', in PowerShell version 3 - as retrieved from
Windows version 'Microsoft Windows Server 2012 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.
Creates a new claim type in Active Directory.
New-ADClaimType [-DisplayName] <String> [-AppliesToClasses <String[]>] [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Description
<String>] [-Enabled <Boolean>] [-ID <String>] [-Instance <ADClaimType>] [-IsSingleValued <Boolean>] [-OtherAttributes <Hashtable>] [-PassThru
[<SwitchParameter>]] [-ProtectedFromAccidentalDeletion <Boolean>] [-RestrictValues <Boolean>] [-Server <String>] [-SuggestedValues
<ADSuggestedValueEntry[]>] -SourceAttribute <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
New-ADClaimType [-DisplayName] <String> [-AppliesToClasses <String[]>] [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Description
<String>] [-Enabled <Boolean>] [-ID <String>] [-Instance <ADClaimType>] [-IsSingleValued <Boolean>] [-OtherAttributes <Hashtable>] [-PassThru
[<SwitchParameter>]] [-ProtectedFromAccidentalDeletion <Boolean>] [-RestrictValues <Boolean>] [-Server <String>] -SourceOID <String> [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
New-ADClaimType [-DisplayName] <String> [-AppliesToClasses <String[]>] [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Description
<String>] [-Enabled <Boolean>] [-ID <String>] [-Instance <ADClaimType>] [-IsSingleValued <Boolean>] [-OtherAttributes <Hashtable>] [-PassThru
[<SwitchParameter>]] [-ProtectedFromAccidentalDeletion <Boolean>] [-RestrictValues <Boolean>] [-Server <String>] [-SuggestedValues
<ADSuggestedValueEntry[]>] -SourceTransformPolicy [<SwitchParameter>] -ValueType <ADClaimValueType> [-Confirm [<SwitchParameter>]] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]
The New-ADClaimType cmdlet creates a new claim type in Active Directory.
<
Online Version: http://go.microsoft.com/fwlink/?LinkId=216375
<
-------------------------- EXAMPLE 1 --------------------------
C:\PS>New-ADClaimType Title -SourceAttribute title
Description
-----------
Create a new user claim type with display name 'Title' that is sourced from the AD attribute 'title'.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>$fullTime = New-Object Microsoft.ActiveDirectory.Management.ADSuggestedValueEntry("FTE", "Full-Time", "Full-time employee");
$intern = New-Object Microsoft.ActiveDirectory.Management.ADSuggestedValueEntry("Intern", "Intern", "Student employee");
$contractor = New-Object Microsoft.ActiveDirectory.Management.ADSuggestedValueEntry("Contractor", "Contractor", "Contract employee");
New-ADClaimType "Employee Type" -SourceAttribute employeeType -SuggestedValues $fullTime,$intern,$contractor
Description
-----------
Create a new user claim type with display name 'Employee Type' that is sourced from the AD attribute 'employeeType'. The suggested values are
set to 'FTE', 'Intern', and 'Contractor'. Applications using this claim type would allow their users to specify one of the suggested values as
this claim type's value.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>New-ADClaimType "Bitlocker Enabled" -SourceOID "1.3.6.1.4.1.311.67.1.1" -Enabled $FALSE
Description
-----------
Create a new device claim type with display name 'Bitlocker Enabled' with the source OID '1.3.6.1.4.1.311.67.1.1'. The claim type set to
disabled.
-------------------------- EXAMPLE 4 --------------------------
PS C:\>New-ADClaimType Title -SourceAttribute title -ID "ad://ext/title"
Description
-----------
Create a new user claim type with display name 'Title' that is sourced from the AD attribute 'title' and ID set to 'ad://ext/title'.
The ID should only be set manually in a multi-forest environment where the same claim type needs to work across forests. By default,
New-ADClaimType generates the ID automatically. For claim types to be considered identical across forests, their ID must be the same.
-------------------------- EXAMPLE 5 --------------------------
PS C:\>New-ADClaimType SourceForest -SourceTransformPolicy -ValueType String
Create a new claim type with display name 'SourceForest' that is sourced from the claims transformation policy engine.