New-AzureADServicePrincipal

  • Referens
Modul:
AzureAD

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 Admin-portalen.

Parametrar

-AccountEnabled

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AlternativeNames

De alternativa namnen för tjänstens huvudnamn

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AppRoleAssignmentRequired

Anger om en programrolltilldelning krävs.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Anger visningsnamnet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorUrl

Anger fel-URL:en.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Homepage

Anger startsidan.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyCredentials

Samlingen med viktiga autentiseringsuppgifter som är associerade med tjänstens huvudnamn.

Type:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogoutUrl

Anger utloggnings-URL:en.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PasswordCredentials

Anger autentiseringsuppgifter för lösenord.

Type:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublisherName

Anger utgivarens namn.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReplyUrls

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SamlMetadataUrl

URL:en för SAML-metadata

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalNames

Anger en matris med namn på 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.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

THe-typen för tjänstens huvudnamn

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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}

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Kommentarer

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