New-AzureADServicePrincipal

  • Referenz
Modul:
AzureAD

Erstellt einen Dienstprinzipal.

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

Beispiele

Beispiel 1: Erstellen eines Dienstprinzipals

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

Mit diesem Befehl wird ein Dienstprinzipal erstellt. Das Tag "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" wird verwendet, damit dieser Dienstprinzipal in der Liste der integrierten Anwendungen im Admin-Portal angezeigt wird.

Parameter

-AccountEnabled

true, wenn das Dienstprinzipalkonto aktiviert ist, andernfalls false.

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

-AlternativeNames

Alternative Namen für diesen Dienstprinzipal

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

-AppId

Der eindeutige Bezeichner für die zugehörige Anwendung (ihre appId-Eigenschaft).

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

-AppRoleAssignmentRequired

Gibt an, ob eine Anwendungsrollenzuweisung erforderlich ist.

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

-DisplayName

Gibt den Anzeigenamen an.

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

-ErrorUrl

Gibt die Fehler-URL an.

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

-Homepage

Gibt die Startseite an.

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

-KeyCredentials

Die Auflistung der Schlüsselanmeldeinformationen, die dem Dienstprinzipal zugeordnet sind.

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

-LogoutUrl

Gibt die Abmelde-URL an.

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

-PasswordCredentials

Gibt Kennwortanmeldeinformationen an.

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

-PublisherName

Gibt den Namen des Herausgebers an.

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

-ReplyUrls

Die URLs, an die Benutzertoken für die Anmeldung mit der zugehörigen Anwendung gesendet werden, oder die Weiterleitungs-URIs, an die OAuth 2.0-Autorisierungscodes und -Zugriffstoken für die zugehörige Anwendung gesendet werden.

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

-SamlMetadataUrl

Die URL für die SAML-Metadaten

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

-ServicePrincipalNames

Gibt ein Array von Dienstprinzipalnamen an. Basierend auf der identifierURIs-Auflistung und der appId-Eigenschaft der Anwendung werden diese URIs verwendet, um auf den Dienstprinzipal einer Anwendung zu verweisen. Ein Client verwendet die folgenden Zwecke:

  • füllen Sie requiredResourceAccess über "Berechtigungen für andere Anwendungen" im klassischen Azure-Portal auf. – Geben Sie einen Ressourcen-URI an, um ein Zugriffstoken abzurufen. Dabei handelt es sich um den im Anspruch zurückgegebenen URI.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicePrincipalType

THe-Typ des Dienstprinzipals

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

-Tags

Tags, die mit diesem Dienstprinzipal verknüpft sind.

Wenn Dieser Dienstprinzipal in der Liste Alle Anwendungen im Verwaltungsportal angezeigt werden soll, müssen Sie diesen Wert auf {WindowsAzureActiveDirectoryIntegratedApp} festlegen.

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

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für New-AzureADServicePrincipal zu Microsoft Graph PowerShell.