Set-EntraApplication

Syntax

Default (Standard)

Set-EntraApplication

    -ApplicationId <String>
    [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]>]
    [-TokenEncryptionKeyId <String>]
    [-SignInAudience <String>]
    [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]>]
    [-ParentalControlSettings <ParentalControlSettings>]
    [-IdentifierUris <System.Collections.Generic.List`1[System.String]>]
    [-AppRoles <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]>]
    [-PublicClient <PublicClientApplication>]
    [-InformationalUrl <InformationalUrl>]
    [-Tags <System.Collections.Generic.List`1[System.String]>]
    [-Api <ApiApplication>]
    [-OptionalClaims <OptionalClaims>]
    [-GroupMembershipClaims <String>]
    [-Web <WebApplication>]
    [-DisplayName <String>]
    [-IsFallbackPublicClient <Boolean>]
    [-IsDeviceOnlyAuthSupported <Boolean>]
    [-RequiredResourceAccess <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]>]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1: Aktualisieren einer Anwendung

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
$params = @{
    ApplicationId = $application.Id
    DisplayName = 'Contoso Entra PowerShell App Production'
    IdentifierUris = 'https://contoso.com'
    GroupMembershipClaims = 'SecurityGroup'
    IsDeviceOnlyAuthSupported = $False
    Tags = 'mytag'
}
Set-EntraApplication @params

Beispiel 2: Aktualisieren einer Anwendung mithilfe des IdentifierUris-Parameters

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
Set-EntraApplication -ApplicationId $application.Id -IdentifierUris 'https://mynewapp.contoso.com'

Beispiel 3: Aktualisieren einer Anwendung mithilfe des Parameters "GroupMembershipClaims"

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
Set-EntraApplication -ApplicationId $application.Id -GroupMembershipClaims 'SecurityGroup'

Beispiel 4: Aktualisieren einer Anwendung mithilfe des Parameters IsDeviceOnlyAuthSupported

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
Set-EntraApplication -ApplicationId $application.Id -IsDeviceOnlyAuthSupported $False

Beispiel 5: Aktualisieren einer Anwendung mithilfe des Tags-Parameters

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -Filter "DisplayName eq 'Contoso Helpdesk Application'"
Set-EntraApplication -ApplicationId $application.Id -Tags 'mytag'

Beispiel 6: Hinzufügen einer Rolle (AppRole) zu einer Anwendung

Connect-Entra -Scopes 'Application.ReadWrite.All','Application.ReadWrite.OwnedBy'
$application = Get-EntraApplication -SearchString 'Contoso Helpdesk Application'
$appRole = New-Object Microsoft.Open.MSGraph.Model.AppRole
$appRole.AllowedMemberTypes = @("User", "Application")
$appRole.Description = "General role"
$appRole.DisplayName = "General"
$appRole.Id = [guid]::NewGuid()
$appRole.IsEnabled = $true
$appRole.Value = "General"
$tags = "WindowsAzureActiveDirectoryIntegratedApp"
Set-EntraApplication -ApplicationId $application.Id -AppRoles $appRole -Tags $tags

Parameter

-Api

Gibt Einstellungen für eine Anwendung an, die eine Web-API implementiert.

Parametereigenschaften

Parametersätze

-ApplicationId

Gibt die ID einer Anwendung in Microsoft Entra ID an.

Parametereigenschaften

Parametersätze

-AppRoles

Die Sammlung von Anwendungsrollen, die eine Anwendung deklarieren kann.

Diese Rollen können Benutzern, Gruppen oder Dienstprinzipalen zugewiesen werden.

Parametereigenschaften

Parametersätze

-DisplayName

Gibt den Anzeigenamen an.

Parametereigenschaften

Parametersätze

-GroupMembershipClaims

Konfiguriert den Gruppenanspruch, der in einem Benutzer- oder OAuth 2.0-Zugriffstoken ausgestellt wurde, das von der Anwendung erwartet wird.

Parametereigenschaften

Parametersätze

-IdentifierUris

Gibt id Uniform Resource Identifiers (URIs) an.

Parametereigenschaften

Parametersätze

-InformationalUrl

Grundlegende Profilinformationen der Anwendung, z. B. Marketing-, Support-, Nutzungsbedingungen und DATENSCHUTZbestimmungen-URLs.

Die Nutzungsbedingungen und Datenschutzbestimmungen werden auf der Oberfläche für die Benutzerzustimmung angezeigt.

Parametereigenschaften

Parametersätze

-IsDeviceOnlyAuthSupported

Gibt an, ob die Anwendung die Authentifizierung mithilfe eines Gerätetokens unterstützt.

Parametereigenschaften

Parametersätze

-IsFallbackPublicClient

Legt den Fallback-Anwendungstyp auf öffentlichen Client fest, z. B. eine installierte Anwendung, die auf einem mobilen Gerät ausgeführt wird.

Der Standardwert bedeutet false , dass der Fallbackanwendungstyp vertraulicher Client wie Web App ist.

Es gibt bestimmte Szenarien, in denen Microsoft Entra ID den Clientanwendungstyp nicht bestimmen können (z. B. ROPC-Fluss, in dem er konfiguriert ist, ohne einen Umleitungs-URI anzugeben).

In diesen Fällen interpretiert Microsoft Entra ID den Anwendungstyp basierend auf dem Wert dieser Eigenschaft.

Parametereigenschaften

Parametersätze

-KeyCredentials

Gibt die wichtigsten Anmeldeinformationen an.

Parametereigenschaften

Parametersätze

-OptionalClaims

Anwendungsentwickler können optionale Ansprüche in ihren Microsoft Entra ID Apps konfigurieren, um anzugeben, welche Ansprüche sie in Token benötigen, die vom Microsoft Sicherheitstokendienst an ihre Anwendung gesendet werden.

Parametereigenschaften

Parametersätze

-ParentalControlSettings

Gibt die Jugendschutzeinstellungen für eine Anwendung an.

Parametereigenschaften

Parametersätze

-PasswordCredentials

Gibt Kennwortanmeldeinformationen an.

Parametereigenschaften

Parametersätze

-PublicClient

Gibt an, ob es sich bei dieser Anwendung um einen öffentlichen Client handelt (z. B. eine installierte Anwendung, die auf einem mobilen Gerät ausgeführt wird). Der Standardwert ist false.

Parametereigenschaften

Parametersätze

-RequiredResourceAccess

Gibt Ressourcen an, auf die diese Anwendung zugreifen muss, sowie die Gruppe von OAuth-Berechtigungsbereichen und Anwendungsrollen, die sie unter den einzelnen Ressourcen benötigt.

Diese Vorkonfiguration des erforderlichen Ressourcenzugriffs steuert die Zustimmungserfahrung.

Parametereigenschaften

Parametersätze

-SignInAudience

Gibt an, welche Microsoft-Konten für die aktuelle Anwendung unterstützt werden.

Parametereigenschaften

Parametersätze

-Tags

Benutzerdefinierte Zeichenfolgen, die zum Kategorisieren und Identifizieren der Anwendung verwendet werden können.

Parametereigenschaften

Parametersätze

-TokenEncryptionKeyId

Gibt die keyId eines öffentlichen Schlüssels aus der keyCredentials-Sammlung an.

Bei der Konfiguration verschlüsselt Microsoft Entra ID alle von ihr ausgegebenen Token mithilfe des Schlüssels, auf den diese Eigenschaft verweist.

Der Anwendungscode, der das verschlüsselte Token erhält, muss das Token mit dem zugehörigen privaten Schlüssel entschlüsseln, bevor es für den angemeldeten Benutzer verwendet werden kann.

Parametereigenschaften

Parametersätze

-Web

Legt die Einstellungen für eine Webanwendung fest.

Parametereigenschaften

Parametersätze

CommonParameters

Eingaben

Boolean

Microsoft.Open.MSGraph.Model.ApiApplication

Microsoft.Open.MSGraph.Model.InformationalUrl

Microsoft.Open.MSGraph.Model.OptionalClaims

Microsoft.Open.MSGraph.Model.ParentalControlSettings

Microsoft.Open.MSGraph.Model.PublicClientApplication

Microsoft.Open.MSGraph.Model.WebApplication

String

System.Collections.Generic.List`1

System.Collections.Generic.List`1

System.Collections.Generic.List`1

System.Collections.Generic.List`1

System.Collections.Generic.List`1

System.Collections.Generic.List`1

System.Nullable`1

Ähnliche Themen

• Get-EntraApplication
• New-EntraApplication
• Remove-EntraApplication