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>]

新しいサービス プリンシパルを作成します。

マルチテナント アプリの場合、呼び出し元のユーザーは、次のMicrosoft Entraロールの少なくとも 1 つに含まれている必要もあります。

• アプリケーション管理者
• クラウド アプリケーション管理者

呼び出し元のユーザーが管理者以外のユーザーであり、バッキング アプリケーションの所有者であるシングルテナント アプリの場合、ユーザーはアプリケーション開発者ロールを持っている必要があります。

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

この例では、Microsoft Entra IDで新しいサービス プリンシパルを作成する方法を示します。 コマンド Get-EntraApplication を使用して、アプリケーション アプリ ID を取得できます。

タグ -Tags {WindowsAzureActiveDirectoryIntegratedApp} は、管理ポータルの統合アプリケーションの一覧にこのサービス プリンシパルを表示するために使用されます。

• -AccountEnabled パラメーターは、サービス プリンシパル アカウントが有効な場合は true、それ以外の場合は false を指定します。
• -AppId パラメーターは、関連付けられているアプリケーションの一意識別子 (その appId プロパティ) を指定します。
• -DisplayName パラメーターは、サービス プリンシパルの表示名を指定します。
• -AppRoleAssignmentRequired パラメーターは、アプリケーション ロールの割り当てが必要かどうかを示します。

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

この例では、Microsoft Entra IDで新しいサービス プリンシパルを作成する方法を示します。 コマンド Get-EntraApplication を使用して、アプリケーション アプリ ID を取得できます。

• -AppId パラメーターは、関連付けられているアプリケーションの一意識別子 (その appId プロパティ) を指定します。
• -Homepage パラメーターは、アプリケーションのホーム ページまたはランディング ページを指定します。
• -LogoutUrl パラメーターはログアウト URL を指定します。
• -ReplyUrls パラメーターは、関連付けられたアプリケーションでサインインするためにユーザー トークンが送信される URL を指定します。

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

この例では、Microsoft Entra IDで新しいサービス プリンシパルを作成する方法を示します。 コマンド Get-EntraApplication を使用して、アプリケーション アプリ ID を取得できます。

• -AppId パラメーターは、関連付けられているアプリケーションの一意識別子 (その appId プロパティ) を指定します。
• -KeyCredentials パラメーターは、サービス プリンシパルに関連付けられているキー資格情報のコレクションを指定します。

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

この例では、Microsoft Entra IDで新しいサービス プリンシパルを作成する方法を示します。 コマンド Get-EntraApplication を使用して、アプリケーション アプリ ID を取得できます。

• -AppId パラメーターは、関連付けられているアプリケーションの一意識別子 (その appId プロパティ) を指定します。
• -AlternativeNames パラメーターは、このサービス プリンシパルの代替名を指定します。
• -ServicePrincipalType パラメーターは、サービス プリンシパルの型を指定します。
• -ServicePrincipalNames パラメーターは、サービス プリンシパル名の配列を指定します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。