New-AzureADServicePrincipal

  • Referenz
Modul:
AzureADPreview

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}

Dieser Befehl erstellt einen Dienstprinzipal. Das Tag "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" wird verwendet, damit dieser Dienstprinzipal in der Liste der integrierten Applicatins 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

Die atlernativen 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 Anmelde-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 Herausgebernamen 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 sowie der AppId-Eigenschaft der Anwendung werden diese URIs verwendet, um auf den Dienstprinzipal einer Anwendung zu verweisen. Ein Client verwendet die folgenden Aktionen:

  • 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, das der im Anspruch zurückgegebene URI ist.
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.

Beachten Sie, dass Wenn Sie beabsichtigen, dass dieser Dienstprinzipal in der Liste "Alle Anwendungen" im Administratorportal angezeigt wird, 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