Delen via

New-AzureADServicePrincipal

  • Referentie
Module:
AzureAD

Hiermee maakt u een service-principal.

Syntaxis

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

Voorbeelden

Voorbeeld 1: een service-principal maken

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

Met deze opdracht maakt u een service-principal. De tag '-Tags {WindowsAzureActiveDirectoryIntegratedApp}' wordt gebruikt om deze service-principal weer te geven in de lijst met geïntegreerde toepassingen in de beheerportal.

Parameters

-AccountEnabled

waar als het service-principal-account is ingeschakeld; anders onwaar.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AlternativeNames

De alternatieve namen voor deze service-principal

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AppId

De unieke id voor de gekoppelde toepassing (de appId-eigenschap).

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AppRoleAssignmentRequired

Geeft aan of een toepassingsroltoewijzing vereist is.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u de weergavenaam op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ErrorUrl

Hiermee geeft u de fout-URL op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Homepage

Hiermee geeft u de startpagina.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-KeyCredentials

De verzameling sleutelreferenties die zijn gekoppeld aan de service-principal.

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LogoutUrl

Hiermee geeft u de afmeldings-URL op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PasswordCredentials

Hiermee geeft u wachtwoordreferenties.

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublisherName

Hiermee geeft u de naam van de uitgever.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ReplyUrls

De URL's waarnaar gebruikerstokens worden verzonden voor aanmelding met de bijbehorende toepassing of de omleidings-URI's waarnaar OAuth 2.0-autorisatiecodes en toegangstokens worden verzonden voor de gekoppelde toepassing.

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SamlMetadataUrl

De URL voor de SAML-metagegevens

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServicePrincipalNames

Hiermee geeft u een matrix met namen van service-principals op. Op basis van de verzameling identifierURIs, plus de appId-eigenschap van de toepassing, worden deze URI's gebruikt om te verwijzen naar de service-principal van een toepassing. Een client gebruikt deze voor het volgende:

  • vul requiredResourceAccess in via 'Machtigingen voor andere toepassingen' in de klassieke Azure-portal. - geef een resource-URI op om een toegangstoken te verkrijgen. Dit is de URI die wordt geretourneerd in de claim.
Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServicePrincipalType

Het type van de service-principal

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tags

Tags die zijn gekoppeld aan deze service-principal.

Houd er rekening mee dat als u van plan bent dat deze service-principal wordt weergegeven in de lijst Alle toepassingen in de beheerportal, u deze waarde moet instellen op {WindowsAzureActiveDirectoryIntegratedApp}

Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Notities

Zie de migratiehandleiding voor New-AzureADServicePrincipal naar Microsoft Graph PowerShell.