New-EntraServicePrincipal

New-EntraServicePrincipal

    -AppId <String>
    [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
    [-Homepage <String>]
    [-LogoutUrl <String>]
    [-ServicePrincipalType <String>]
    [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
    [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
    [-Tags <System.Collections.Generic.List`1[System.String]>]
    [-AccountEnabled <String>]
    [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
    [-AppRoleAssignmentRequired <Boolean>]
    [-DisplayName <String>]
    [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

Créez un principal de service.

Pour les applications mutualisées, l’utilisateur appelant doit également se trouver dans au moins l’un des rôles Microsoft Entra suivants :

• Administrateur d’application
• Administrateur d’applications cloud

Pour les applications monolocataires où l’utilisateur appelant est un utilisateur non administrateur, mais qui est le propriétaire de l’application de stockage, l’utilisateur doit avoir le rôle Développeur d’applications.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Helpdesk Application'"
$params = @{
    AccountEnabled = $true
    AppId = $application.AppId
    AppRoleAssignmentRequired = $true
    DisplayName = $application.DisplayName
    Tags = {WindowsAzureActiveDirectoryIntegratedApp}
}
New-EntraServicePrincipal @params

DisplayName Id                                   AppId                                SignInAudience ServicePrincipalType
----------- --                                   -----                                -------------- --------------------
Helpdesk Application    bbbbbbbb-1111-2222-3333-cccccccccccc 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMyOrg   Application

Cet exemple montre comment créer un principal de service dans Microsoft Entra ID. Vous pouvez utiliser la commande Get-EntraApplication pour obtenir l’ID de l’application.

La balise -Tags {WindowsAzureActiveDirectoryIntegratedApp} est utilisée pour que ce principal de service s’affiche dans la liste des applications intégrées dans le portail d’administration.

• -AccountEnabled le paramètre spécifie true si le compte principal de service est activé, sinon false.
• -AppId spécifie l’identificateur unique de l’application associée (sa propriété appId).
• -DisplayName spécifie le nom complet du principal de service.
• -AppRoleAssignmentRequired indique si une attribution de rôle d’application est requise.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Helpdesk Application'"
$params = @{
    AppId = $application.AppId
    Homepage = 'https://localhost/home'
    LogoutUrl = 'htpp://localhost/logout'
    ReplyUrls = 'https://localhost/redirect'
}
New-EntraServicePrincipal @params

DisplayName Id                                   AppId                                SignInAudience ServicePrincipalType
----------- --                                   -----                                -------------- --------------------
Helpdesk Application    bbbbbbbb-1111-2222-3333-cccccccccccc 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMyOrg   Application

Cet exemple montre comment créer un principal de service dans Microsoft Entra ID. Vous pouvez utiliser la commande Get-EntraApplication pour obtenir l’ID de l’application.

• -AppId spécifie l’identificateur unique de l’application associée (sa propriété appId).
• -Homepage spécifie la page d’accueil ou la page d’accueil de l’application.
• -LogoutUrl spécifie l’URL de déconnexion.
• -ReplyUrls spécifie les URL auxquelles les jetons utilisateur sont envoyés pour la connexion avec l’application associée.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$creds = New-Object Microsoft.Open.AzureAD.Model.KeyCredential
$creds.CustomKeyIdentifier = [System.Text.Encoding]::UTF8.GetBytes('Test')
$startdate = Get-Date -Year 2023 -Month 10 -Day 23
$creds.StartDate = $startdate
$creds.Type = 'Symmetric'
$creds.Usage = 'Sign'
$creds.Value = [System.Text.Encoding]::UTF8.GetBytes('strong-cred-value')
$creds.EndDate = Get-Date -Year 2024 -Month 10 -Day 23
$application = Get-EntraApplication -Filter "DisplayName eq 'Helpdesk Application'"

New-EntraServicePrincipal -AppId $application.AppId -KeyCredentials $creds

DisplayName Id                                   AppId                                SignInAudience ServicePrincipalType
----------- --                                   -----                                -------------- --------------------
Helpdesk Application    bbbbbbbb-1111-2222-3333-cccccccccccc 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADMyOrg   Application

Cet exemple montre comment créer un principal de service dans Microsoft Entra ID. Vous pouvez utiliser la commande Get-EntraApplication pour obtenir l’ID de l’application.

• -AppId spécifie l’identificateur unique de l’application associée (sa propriété appId).
• -KeyCredentials spécifie la collection d’informations d’identification de clé associées au principal de service.

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Helpdesk Application'"
New-EntraServicePrincipal -AppId $application.AppId -AlternativeNames 'sktest2' -ServicePrincipalType 'Application' -ServicePrincipalNames $application.AppId

DisplayName Id                                   AppId                                SignInAudience                     ServicePrincipalType
----------- --                                   -----                                --------------                     --------------------
Helpdesk Application   bbbbbbbb-1111-2222-3333-cccccccccccc 00001111-aaaa-2222-bbbb-3333cccc4444 AzureADandPersonalMicrosoftAccount Application

Cet exemple montre comment créer un principal de service dans Microsoft Entra ID. Vous pouvez utiliser la commande Get-EntraApplication pour obtenir l’ID de l’application.

• -AppId spécifie l’identificateur unique de l’application associée (sa propriété appId).
• -AlternativeNames spécifie les autres noms de ce principal de service.
• -ServicePrincipalType spécifie le type du principal de service.
• -ServicePrincipalNames spécifie un tableau de noms de principaux de service.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.