Set-EntraApplication

Modul:: Microsoft.Entra.Applications Module v1.3

Frissíti egy alkalmazásobjektum tulajdonságait.

Syntax

Default (Alapértelmezett)

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

Frissíti egy alkalmazásobjektum tulajdonságait.

Példák

1. példa: Alkalmazás frissítése

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

Ez a parancs frissíti az alkalmazást Microsoft Entra ID.

2. példa: Alkalmazás frissítése Az IdentifierUris paraméterrel

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'

Ez a parancs frissíti az alkalmazást Microsoft Entra ID.

3. példa: Alkalmazás frissítése a GroupMembershipClaims paraméterrel

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'

Ez a parancs frissíti az alkalmazást Microsoft Entra ID.

4. példa: Alkalmazás frissítése IsDeviceOnlyAuthSupported paraméterrel

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

Ez a parancs frissíti az alkalmazást Microsoft Entra ID.

5. példa: Alkalmazás frissítése Címkék paraméterrel

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'

Ez a parancs frissíti az alkalmazást Microsoft Entra ID.

6. példa: Szerepkör (AppRole) hozzáadása egy alkalmazáshoz

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

Ez a parancs alkalmazásszerepkört ad hozzá egy alkalmazáshoz. A meglévő alkalmazásszerepkörök megőrzéséhez vegye fel őket a kérésbe. A nem szereplő szerepkörök lecserélődnek. Ez az objektum szinkronizálódik a bérlő megfelelő szolgáltatásnév tulajdonságával.

A AllowedMemberTypes következő értékek fogadhatók el:

@("User", "Application") - felhasználók, csoportok és alkalmazások számára.
"User" - felhasználók és csoportok számára.
"Application" - alkalmazásokhoz.

Paraméterek

-Api

Megadja a webes API-t implementáló alkalmazások beállításait.

Paramétertulajdonságok

Típus:	ApiApplication
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ApplicationId

Egy alkalmazás azonosítóját adja meg a Microsoft Entra ID.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	ObjectId (objektumazonosító)

Paraméterkészletek

(All)

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-AppRoles

Az alkalmazás által deklarálható alkalmazásszerepkörök gyűjteménye.

Ezek a szerepkörök hozzárendelhetők felhasználókhoz, csoportokhoz vagy szolgáltatásnevekhez.

Paramétertulajdonságok

Típus:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-DisplayName

Megadja a megjelenítendő nevet.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-GroupMembershipClaims

Konfigurálja az alkalmazás által várt felhasználói vagy OAuth 2.0 hozzáférési jogkivonatban kibocsátott csoportjogkivonatot.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IdentifierUris

Az azonosítók egységes erőforrás-azonosítóit (URI-ket) adja meg.

Paramétertulajdonságok

Típus:	System.Collections.Generic.List`1[System.String]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-InformationalUrl

Az alkalmazás alapvető profiladatai, például az alkalmazás marketingje, támogatása, szolgáltatási feltételei és adatvédelmi nyilatkozatának URL-címei.

A használati feltételek és az adatvédelmi nyilatkozat a felhasználói hozzájárulási felületen keresztül kerülnek felszínre a felhasználók számára.

Paramétertulajdonságok

Típus:	InformationalUrl
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IsDeviceOnlyAuthSupported

Megadja, hogy az alkalmazás támogatja-e az eszközjogkivonat használatával történő hitelesítést.

Paramétertulajdonságok

Típus:	System.Boolean
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IsFallbackPublicClient

A tartalék alkalmazás típusát adja meg nyilvános ügyfélként, például mobileszközön futó telepített alkalmazást.

Az alapértelmezett érték azt false jelenti, hogy a tartalék alkalmazás típusa bizalmas ügyfél, például webalkalmazás.

Vannak olyan esetek, amikor Microsoft Entra ID nem tudják meghatározni az ügyfélalkalmazás típusát (például a ROPC-folyamatot, ahol az átirányítási URI megadása nélkül van konfigurálva).

Ezekben az esetekben a Microsoft Entra ID a tulajdonság értéke alapján értelmezi az alkalmazás típusát.

Paramétertulajdonságok

Típus:	System.Boolean
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-KeyCredentials

Megadja a kulcs hitelesítő adatait.

Paramétertulajdonságok

Típus:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-OptionalClaims

Az alkalmazásfejlesztők a Microsoft Entra ID-alkalmazásaikban konfigurálhatják az opcionális jogcímeket, hogy megadják, mely jogcímeket szeretnék az alkalmazásuknak küldött jogkivonatokban a Microsoft biztonsági jogkivonat-szolgáltatás által.

Paramétertulajdonságok

Típus:	OptionalClaims
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ParentalControlSettings

Egy alkalmazás szülői felügyeleti beállításait adja meg.

Paramétertulajdonságok

Típus:	ParentalControlSettings
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PasswordCredentials

Megadja a jelszó hitelesítő adatait.

Paramétertulajdonságok

Típus:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PublicClient

Megadja, hogy ez az alkalmazás nyilvános ügyfél-e (például mobileszközön futó telepített alkalmazás). Az alapértelmezett érték false.

Paramétertulajdonságok

Típus:	PublicClientApplication
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-RequiredResourceAccess

Meghatározza azokat az erőforrásokat, amelyekhez az alkalmazásnak hozzáférésre van szüksége, valamint az OAuth-engedély hatóköreinek és alkalmazásszerepköreinek készletét, amelyekre az egyes erőforrásokhoz szüksége van.

A szükséges erőforrás-hozzáférés ezen előkonfigurációja vezérli a hozzájárulási élményt.

Paramétertulajdonságok

Típus:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-SignInAudience

Megadja, hogy az aktuális alkalmazás mely Microsoft-fiókokat támogatja.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Tags

Az alkalmazás kategorizálására és azonosítására használható egyéni sztringek.

Paramétertulajdonságok

Típus:	System.Collections.Generic.List`1[System.String]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-TokenEncryptionKeyId

Egy nyilvános kulcs kulcsazonosítóját adja meg a keyCredentials gyűjteményből.

Ha konfigurálva van, a Microsoft Entra ID titkosítja az általa kibocsátott összes jogkivonatot a tulajdonság által használt kulcs használatával.

A titkosított jogkivonatot fogadó alkalmazáskódnak a megfelelő titkos kulccsal kell visszafejtenie a jogkivonatot, mielőtt az a bejelentkezett felhasználó számára használható lenne.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Web

Webalkalmazás beállításait adja meg.

Paramétertulajdonságok

Típus:	WebApplication
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

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.Nullable`1

Visszajelzés

Hasznosnak találta ezt az oldalt?