The New-EntraApplication cmdlet creates a new application registration in Microsoft Entra ID. Applications can be configured for different authentication scenarios, including single-tenant or multitenant, and can use various credential types.
Parameters
-AddIns
Defines custom behavior extensions for the application.
Parameter properties
Type:
System.Object[]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateApplication
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-AdditionalProperties
Custom properties to send directly to the Microsoft Graph API.
Parameter properties
Type:
Hashtable
Default value:
None
Supports wildcards:
False
DontShow:
False
Aliases:
Body, Properties, BodyParameter
Parameter sets
CreateWithAdditionalProperties
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Api
The API settings for the application, including OAuth2 permission scopes and app roles.
Defines which accounts are supported for this application. Valid values: AzureADMyOrg, AzureADMultipleOrgs, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateApplication
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Tags
Custom tags that can be used to categorize and identify the application.
Parameter properties
Type:
System.Collections.Generic.List`1[System.String]
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateApplication
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TokenEncryptionKeyId
Specifies the keyId of a public key from the keyCredentials collection for token encryption.
Parameter properties
Type:
String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
CreateApplication
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Web
Settings for a web application, including redirect URIs and logout URL.
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.
Inputs
None
This cmdlet doesn't accept pipeline input.
Outputs
PSCustomObject
Returns a custom object representing the created Microsoft Entra application.
Notes
This cmdlet requires the 'Application.ReadWrite.All' permission scope.
When using certificate credentials, ensure proper certificate management practices:
Use strong key sizes (RSA 2048-bit or higher)
Store private keys securely
Implement certificate rotation before expiration
Password credentials (client secrets) should be used only when certificates can't be used.
For security best practices, consider:
Using the least privilege principle when assigning API permissions
Limiting application roles to only what's necessary
Using conditional access policies for sensitive applications