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

Description

Exempel

Exempel 1: Uppdatera ett program

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

Exempel 2: Uppdatera ett program med parametern IdentifierUris

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'

Exempel 3: Uppdatera ett program med parametern 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'

Exempel 4: Uppdatera ett program med parametern 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

Exempel 5: Uppdatera ett program med hjälp av parametern Taggar

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'

Exempel 6: Lägg till en roll (AppRole) i ett program

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

Parametrar

-Api

Anger inställningar för ett program som implementerar ett webb-API.

Parameteregenskaper

Parameteruppsättningar

-ApplicationId

Anger ID för ett program i Microsoft Entra ID.

Parameteregenskaper

Parameteruppsättningar

-AppRoles

Den samling programroller som ett program kan deklarera.

Dessa roller kan tilldelas till användare, grupper eller tjänstehuvudprincipaler.

Parameteregenskaper

Parameteruppsättningar

-DisplayName

Anger visningsnamnet.

Parameteregenskaper

Parameteruppsättningar

-GroupMembershipClaims

Konfigurerar det gruppanspråk som utfärdats i en användare eller OAuth 2.0-åtkomsttoken som programmet förväntar sig.

Parameteregenskaper

Parameteruppsättningar

-IdentifierUris

Anger identifierare för enhetliga resursidentifierare (URI:er).

Parameteregenskaper

Parameteruppsättningar

-InformationalUrl

Grundläggande profilinformation för programmet, till exempel appens marknadsföring, support, användarvillkor och URL:er för sekretesspolicy.

Användarvillkoren och sekretesspolicyn visas för användarna via användarmedgivandeupplevelsen.

Parameteregenskaper

Parameteruppsättningar

-IsDeviceOnlyAuthSupported

Anger om programmet stöder autentisering med hjälp av en enhetstoken.

Parameteregenskaper

Parameteruppsättningar

-IsFallbackPublicClient

Anger programtypen för återställning som offentlig klient, till exempel ett installerat program som körs på en mobil enhet.

Standardvärdet är false att det innebär att programtypen för återställning är konfidentiell klient, till exempel webbapp.

Det finns vissa scenarier där Microsoft Entra ID inte kan fastställa klientprogramtypen (till exempel ROPC-flöde där det har konfigurerats utan att ange en omdirigerings-URI).

I dessa fall tolkar Microsoft Entra-ID programtypen baserat på värdet för den här egenskapen.

Parameteregenskaper

Parameteruppsättningar

-KeyCredentials

Anger autentiseringsuppgifter för nycklar.

Parameteregenskaper

Parameteruppsättningar

-OptionalClaims

Programutvecklare kan konfigurera valfria anspråk i sina Microsoft Entra ID appar för att ange vilka anspråk de vill ha i token som skickas till deras program av tjänsten Microsoft säkerhetstoken.

Parameteregenskaper

Parameteruppsättningar

-ParentalControlSettings

Anger inställningar för föräldrakontroll för ett program.

Parameteregenskaper

Parameteruppsättningar

-PasswordCredentials

Anger autentiseringsuppgifter för lösenord.

Parameteregenskaper

Parameteruppsättningar

-PublicClient

Anger om det här programmet är en offentlig klient (till exempel ett installerat program som körs på en mobil enhet). Standard är false.

Parameteregenskaper

Parameteruppsättningar

-RequiredResourceAccess

Anger resurser som programmet kräver åtkomst till och den uppsättning OAuth-behörighetsomfång och programroller som behövs under var och en av dessa resurser.

Den här förkonfigurationen av nödvändig resursåtkomst styr medgivandeupplevelsen.

Parameteregenskaper

Parameteruppsättningar

-SignInAudience

Anger vilka Microsoft-konton som stöds för det aktuella programmet.

Parameteregenskaper

Parameteruppsättningar

-Tags

Anpassade strängar som kan användas för att kategorisera och identifiera programmet.

Parameteregenskaper

Parameteruppsättningar

-TokenEncryptionKeyId

Anger keyId för en offentlig nyckel från samlingen keyCredentials.

När microsoft Entra-ID konfigureras krypteras alla token som genereras med hjälp av nyckeln som den här egenskapen pekar på.

Programkoden som tar emot den krypterade token måste använda den matchande privata nyckeln för att dekryptera token innan den kan användas för den inloggade användaren.

Parameteregenskaper

Parameteruppsättningar

-Web

Anger inställningar för ett webbprogram.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

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

Relaterade länkar

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