New-AzureADServicePrincipal

Skapar ett huvudnamn för tjänsten.

Syntax

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

Exempel

Exempel 1: Skapa ett huvudnamn för tjänsten

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

Det här kommandot skapar ett huvudnamn för tjänsten. Taggen "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" används för att tjänstens huvudnamn ska visas i listan över integrerade program i administrationsportalen.

Parametrar

-AccountEnabled

true om kontot för tjänstens huvudnamn är aktiverat. annars falskt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AlternativeNames

De alternativa namnen för tjänstens huvudnamn

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AppId

Den unika identifieraren för det associerade programmet (dess appId-egenskap).

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AppRoleAssignmentRequired

Anger om en programrolltilldelning krävs.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger visningsnamnet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ErrorUrl

Anger fel-URL:en.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Homepage

Anger startsidan.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-KeyCredentials

Samlingen med nyckelautentiseringsuppgifter som är associerade med tjänstens huvudnamn.

Typ:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LogoutUrl

Anger utloggnings-URL:en.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PasswordCredentials

Anger autentiseringsuppgifter för lösenord.

Typ:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublisherName

Anger utgivarens namn.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ReplyUrls

Url:erna som användartoken skickas till för inloggning med det associerade programmet, eller de omdirigerings-URI:er som OAuth 2.0-auktoriseringskoder och åtkomsttoken skickas till för det associerade programmet.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SamlMetadataUrl

URL:en för SAML-metadata

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServicePrincipalNames

Anger en matris med tjänstens huvudnamn. Baserat på samlingen identifierURI:er, plus programmets appId-egenskap, används dessa URI:er för att referera till ett programs tjänsthuvudnamn. En klient använder dessa för att:

  • fyll i requiredResourceAccess via "Behörigheter till andra program" i den klassiska Azure-portalen. – ange en resurs-URI för att hämta en åtkomsttoken, vilket är den URI som returneras i anspråket.
Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServicePrincipalType

Typ av tjänstens huvudnamn

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tags

Taggar som är länkade till tjänstens huvudnamn.

Observera att om du tänker att tjänstens huvudnamn ska visas i listan Alla program i administratörsportalen måste du ange det här värdet till {WindowsAzureActiveDirectoryIntegratedApp}

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Kommentarer

Se migreringsguiden för New-AzureADServicePrincipal till Microsoft Graph PowerShell.