Set-EntraApplication

Modül:: Microsoft.Entra.Applications Module v1.3

Uygulama nesnesinin özelliklerini güncelleştirir.

Syntax

Default (Varsayılan)

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

Uygulama nesnesinin özelliklerini güncelleştirir.

Örnekler

Örnek 1: Uygulamayı güncelleştirme

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

Bu komut, Microsoft Entra ID bir uygulamayı güncelleştirir.

Örnek 2: IdentifierUris parametresini kullanarak bir uygulamayı güncelleştirme

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'

Bu komut, Microsoft Entra ID bir uygulamayı güncelleştirir.

Örnek 3: GroupMembershipClaims parametresini kullanarak bir uygulamayı güncelleştirme

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'

Bu komut, Microsoft Entra ID bir uygulamayı güncelleştirir.

Örnek 4: IsDeviceOnlyAuthSupported parametresini kullanarak bir uygulamayı güncelleştirme

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

Bu komut, Microsoft Entra ID bir uygulamayı güncelleştirir.

Örnek 5: Tags parametresini kullanarak bir uygulamayı güncelleştirme

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'

Bu komut, Microsoft Entra ID bir uygulamayı güncelleştirir.

Örnek 6: Uygulamaya rol (AppRole) ekleme

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

Bu komut bir uygulamaya uygulama rolü ekler. Mevcut uygulama rollerini korumak için bunları isteğinize ekleyin. Dahil edilmeyen roller değiştirilir. Bu nesne, kiracıdaki ilgili hizmet sorumlusu özelliğiyle eşitlenir.

AllowedMemberTypes değerleri alabilir:

@("User", "Application") - kullanıcılar, gruplar ve uygulamalar için.
"User" - kullanıcılar ve gruplar için.
"Application" - uygulamalar için.

Parametreler

-Api

Web API'sini uygulayan bir uygulamanın ayarlarını belirtir.

Parametre özellikleri

Tür:	ApiApplication
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ApplicationId

Microsoft Entra ID bir uygulamanın kimliğini belirtir.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Nesne Kimliği

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AppRoles

Bir uygulamanın bildirebileceği uygulama rollerinin koleksiyonu.

Bu roller kullanıcılara, gruplara veya hizmet sorumlularına atanabilir.

Parametre özellikleri

Tür:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DisplayName

Görünen adı belirtir.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-GroupMembershipClaims

Uygulamanın beklediği bir kullanıcı veya OAuth 2.0 erişim belirtecinde verilen grup talebi yapılandırılır.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IdentifierUris

Tanımlayıcı Tekdüzen Kaynak Tanımlayıcılarını (URI' ler) belirtir.

Parametre özellikleri

Tür:	System.Collections.Generic.List`1[System.String]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-InformationalUrl

Uygulamanın pazarlama, destek, hizmet koşulları ve gizlilik bildirimi URL'leri gibi uygulamanın temel profil bilgileri.

Hizmet koşulları ve gizlilik bildirimi, kullanıcı onayı deneyimi aracılığıyla kullanıcılara sunulur.

Parametre özellikleri

Tür:	InformationalUrl
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IsDeviceOnlyAuthSupported

Uygulamanın bir cihaz belirteci kullanarak kimlik doğrulamasını desteklenip desteklemediğini belirtir.

Parametre özellikleri

Tür:	System.Boolean
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IsFallbackPublicClient

Mobil cihazda çalışan yüklü bir uygulama gibi geri dönüş uygulama türünü genel istemci olarak belirtir.

Varsayılan değer, false geri dönüş uygulama türünün web uygulaması gibi gizli bir istemci olduğu anlamına gelir.

Microsoft Entra ID istemci uygulama türünü belirleyemediğini (örneğin, yeniden yönlendirme URI'sini belirtmeden yapılandırıldığı ROPC akışı) bazı senaryolar vardır.

Bu gibi durumlarda Microsoft Entra Id, uygulama türünü bu özelliğin değerine göre yorumlar.

Parametre özellikleri

Tür:	System.Boolean
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-KeyCredentials

Anahtar kimlik bilgilerini belirtir.

Parametre özellikleri

Tür:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-OptionalClaims

Uygulama geliştiricileri, Microsoft Entra ID uygulamalarında isteğe bağlı talepleri yapılandırarak Microsoft güvenlik belirteci hizmeti tarafından uygulamalarına gönderilen belirteçlerde hangi talepleri istediklerini belirtebilir.

Parametre özellikleri

Tür:	OptionalClaims
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ParentalControlSettings

Bir uygulamanın ebeveyn denetimi ayarlarını belirtir.

Parametre özellikleri

Tür:	ParentalControlSettings
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PasswordCredentials

Parola kimlik bilgilerini belirtir.

Parametre özellikleri

Tür:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PublicClient

Bu uygulamanın genel bir istemci olup olmadığını belirtir (örneğin, mobil cihazda çalışan yüklü bir uygulama). Varsayılan false değeridir.

Parametre özellikleri

Tür:	PublicClientApplication
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredResourceAccess

Bu uygulamanın erişim gerektirdiği kaynakları ve bu kaynakların her biri altında ihtiyaç duyduğu OAuth izin kapsamları ve uygulama rolleri kümesini belirtir.

Gerekli kaynak erişiminin bu ön yapılandırması onay deneyimini yönlendirmektedir.

Parametre özellikleri

Tür:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SignInAudience

Geçerli uygulama için hangi Microsoft hesaplarının desteklendiği belirtir.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Tags

Uygulamayı kategorilere ayırmak ve tanımlamak için kullanılabilecek özel dizeler.

Parametre özellikleri

Tür:	System.Collections.Generic.List`1[System.String]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TokenEncryptionKeyId

keyCredentials koleksiyonundan bir ortak anahtarın keyId değerini belirtir.

Yapılandırıldığında, Microsoft Entra Id bu özelliğin işaret ettiği anahtarı kullanarak yaydığı tüm belirteçleri şifreler.

Şifrelenmiş belirteci alan uygulama kodu, oturum açmış kullanıcı için kullanılmadan önce belirtecin şifresini çözmek için eşleşen özel anahtarı kullanmalıdır.

Parametre özellikleri

Tür:	System.String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Web

Bir web uygulamasının ayarlarını belirtir.

Parametre özellikleri

Tür:	WebApplication
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?