Set-EntraApplication
Hiermee worden de eigenschappen van een toepassingsobject bijgewerkt.
Syntax
Default (Standaard)
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
Hiermee worden de eigenschappen van een toepassingsobject bijgewerkt.
Voorbeelden
Voorbeeld 1: Een toepassing bijwerken
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
Met deze opdracht wordt een toepassing bijgewerkt in Microsoft Entra ID.
Voorbeeld 2: Een toepassing bijwerken met de parameter 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'
Met deze opdracht wordt een toepassing bijgewerkt in Microsoft Entra ID.
Voorbeeld 3: Een toepassing bijwerken met de parameter 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'
Met deze opdracht wordt een toepassing bijgewerkt in Microsoft Entra ID.
Voorbeeld 4: Een toepassing bijwerken met de parameter 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
Met deze opdracht wordt een toepassing bijgewerkt in Microsoft Entra ID.
Voorbeeld 5: Een toepassing bijwerken met de parameter Tags
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'
Met deze opdracht wordt een toepassing bijgewerkt in Microsoft Entra ID.
Voorbeeld 6: Een rol (AppRole) toevoegen aan een toepassing
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
Met deze opdracht wordt een app-rol toegevoegd aan een toepassing. Als u bestaande app-rollen wilt behouden, neemt u deze op in uw aanvraag. Rollen die niet zijn opgenomen, worden vervangen. Dit object wordt gesynchroniseerd met de bijbehorende eigenschap van de service-principal in de tenant.
De AllowedMemberTypes waarden kunnen als volgende worden gebruikt:
-
@("User", "Application")- voor gebruikers, groepen en toepassingen. -
"User"- voor gebruikers en groepen. -
"Application"- voor toepassingen.
Parameters
-Api
Hiermee geeft u instellingen op voor een toepassing die een web-API implementeert.
Parametereigenschappen
| Type: | ApiApplication |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ApplicationId
Hiermee geeft u de id van een toepassing in Microsoft Entra ID.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | ObjectId |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-AppRoles
De verzameling toepassingsrollen die een toepassing kan declareren.
Deze rollen kunnen worden toegewezen aan gebruikers, groepen of service-principals.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-DisplayName
Hiermee geeft u de weergavenaam.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-GroupMembershipClaims
Hiermee configureert u de groepsclaim die is uitgegeven in een gebruiker of OAuth 2.0-toegangstoken dat de toepassing verwacht.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-IdentifierUris
Hiermee geeft u id Uniform Resource Identifiers (URI's).
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[System.String] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-InformationalUrl
Basisprofielgegevens van de toepassing, zoals marketing, ondersteuning, servicevoorwaarden en URL's voor privacyverklaring.
De servicevoorwaarden en privacyverklaring worden aan de gebruikers weergegeven via de gebruikerstoestemming.
Parametereigenschappen
| Type: | InformationalUrl |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-IsDeviceOnlyAuthSupported
Hiermee geeft u op of de toepassing verificatie ondersteunt met behulp van een apparaattoken.
Parametereigenschappen
| Type: | System.Boolean |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-IsFallbackPublicClient
Hiermee geeft u het type terugvaltoepassing op als openbare client, zoals een geïnstalleerde toepassing die op een mobiel apparaat wordt uitgevoerd.
De standaardwaarde is false dat het terugvaltoepassingstype vertrouwelijke client is, zoals web-app.
Er zijn bepaalde scenario's waarin Microsoft Entra ID het type clienttoepassing niet kunnen bepalen (bijvoorbeeld ROPC-stroom waar deze is geconfigureerd zonder een omleidings-URI op te geven).
In die gevallen interpreteert Microsoft Entra ID het toepassingstype op basis van de waarde van deze eigenschap.
Parametereigenschappen
| Type: | System.Boolean |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-KeyCredentials
Hiermee geeft u sleutelreferenties.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-OptionalClaims
Toepassingsontwikkelaars kunnen optionele claims in hun Microsoft Entra ID-apps configureren om op te geven welke claims ze in tokens willen verzenden naar hun toepassing door de Microsoft beveiligingstokenservice.
Parametereigenschappen
| Type: | OptionalClaims |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ParentalControlSettings
Hiermee geeft u instellingen voor ouderlijk toezicht voor een toepassing.
Parametereigenschappen
| Type: | ParentalControlSettings |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-PasswordCredentials
Hiermee geeft u wachtwoordreferenties.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-PublicClient
Hiermee geeft u op of deze toepassing een openbare client is (zoals een geïnstalleerde toepassing die op een mobiel apparaat wordt uitgevoerd). De standaardwaarde is false.
Parametereigenschappen
| Type: | PublicClientApplication |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-RequiredResourceAccess
Hiermee geeft u resources op waartoe deze toepassing toegang nodig heeft en de set OAuth-machtigingsbereiken en toepassingsrollen die nodig zijn voor elk van deze resources.
Deze preconfiguratie van vereiste toegang tot resources zorgt voor de toestemmingservaring.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-SignInAudience
Geeft aan welke Microsoft-accounts voor de huidige toepassing worden ondersteund.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Tags
Aangepaste tekenreeksen die kunnen worden gebruikt om de toepassing te categoriseren en te identificeren.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[System.String] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-TokenEncryptionKeyId
Hiermee geeft u de keyId van een openbare sleutel uit de verzameling keyCredentials.
Wanneer deze is geconfigureerd, versleutelt Microsoft Entra-id alle tokens die worden verzonden met behulp van de sleutel waar deze eigenschap naar verwijst.
De toepassingscode die het versleutelde token ontvangt, moet de overeenkomende persoonlijke sleutel gebruiken om het token te ontsleutelen voordat het kan worden gebruikt voor de aangemelde gebruiker.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Web
Hiermee geeft u instellingen voor een webtoepassing.
Parametereigenschappen
| Type: | WebApplication |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.