Set-EntraApplication

모듈:: Microsoft.Entra.Applications Module v1.3

애플리케이션 개체의 속성을 업데이트합니다.

구문

Default (기본값)

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

애플리케이션 개체의 속성을 업데이트합니다.

예제

예제 1: 애플리케이션 업데이트

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

이 명령은 Microsoft Entra ID 애플리케이션을 업데이트합니다.

예제 2: 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'

이 명령은 Microsoft Entra ID 애플리케이션을 업데이트합니다.

예제 3: 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'

이 명령은 Microsoft Entra ID 애플리케이션을 업데이트합니다.

예제 4: 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

이 명령은 Microsoft Entra ID 애플리케이션을 업데이트합니다.

예제 5: 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'

이 명령은 Microsoft Entra ID 애플리케이션을 업데이트합니다.

예제 6: 애플리케이션에 역할 추가(AppRole)

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

이 명령은 애플리케이션에 앱 역할을 추가합니다. 기존 앱 역할을 유지하려면 요청에 해당 역할을 포함합니다. 포함되지 않은 모든 역할이 대체됩니다. 이 개체는 테넌트에서 해당 서비스 주체 속성과 동기화됩니다.

값을 AllowedMemberTypes 사용할 수 있습니다.

@("User", "Application") - 사용자, 그룹 및 애플리케이션용입니다.
"User" - 사용자 및 그룹용입니다.
"Application" - 애플리케이션용입니다.

매개 변수

-Api

웹 API를 구현하는 애플리케이션에 대한 설정을 지정합니다.

매개 변수 속성

형식:	ApiApplication
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ApplicationId

Microsoft Entra ID 애플리케이션의 ID를 지정합니다.

매개 변수 속성

형식:	System.String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	ObjectId (오브젝트아이디)

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-AppRoles

애플리케이션에서 선언할 수 있는 애플리케이션 역할의 컬렉션입니다.

이러한 역할은 사용자, 그룹 또는 서비스 주체에게 할당될 수 있습니다.

매개 변수 속성

형식:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DisplayName

표시 이름을 지정합니다.

매개 변수 속성

형식:	System.String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-GroupMembershipClaims

애플리케이션에서 예상하는 사용자 또는 OAuth 2.0 액세스 토큰에서 발급된 그룹 클레임을 구성합니다.

매개 변수 속성

형식:	System.String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IdentifierUris

식별자 URI(Uniform Resource Identifier)를 지정합니다.

매개 변수 속성

형식:	System.Collections.Generic.List`1[System.String]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-InformationalUrl

앱의 마케팅, 지원, 서비스 약관 및 개인정보처리방침 URL과 같은 애플리케이션의 기본 프로필 정보입니다.

서비스 약관 및 개인정보처리방침은 사용자 동의 환경을 통해 사용자에게 표시됩니다.

매개 변수 속성

형식:	InformationalUrl
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IsDeviceOnlyAuthSupported

애플리케이션이 디바이스 토큰을 사용하여 인증을 지원하는지 지정합니다.

매개 변수 속성

형식:	System.Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IsFallbackPublicClient

설치된 애플리케이션이 모바일 기기에서 실행되는 것과 같은 공개 클라이언트로 대체 애플리케이션 유형을 지정합니다.

기본값은 false 대체 애플리케이션 유형이 웹앱과 같은 기밀 클라이언트임을 의미합니다.

Microsoft Entra ID 클라이언트 애플리케이션 유형을 확인할 수 없는 특정 시나리오가 있습니다(예: 리디렉션 URI를 지정하지 않고 구성된 ROPC 흐름).

이러한 경우 Microsoft Entra ID는 이 속성 값을 기반으로 애플리케이션 유형을 해석합니다.

매개 변수 속성

형식:	System.Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-KeyCredentials

키 자격 증명을 지정합니다.

매개 변수 속성

형식:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-OptionalClaims

애플리케이션 개발자는 Microsoft Entra ID 앱에서 선택적 클레임을 구성하여 Microsoft 보안 토큰 서비스에서 애플리케이션에 보낸 토큰에서 원하는 클레임을 지정할 수 있습니다.

매개 변수 속성

형식:	OptionalClaims
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ParentalControlSettings

애플리케이션에 대한 자녀 보호 설정을 지정합니다.

매개 변수 속성

형식:	ParentalControlSettings
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PasswordCredentials

암호 자격 증명을 지정합니다.

매개 변수 속성

형식:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PublicClient

이 애플리케이션이 공용 클라이언트(예: 모바일 디바이스에서 실행되는 설치된 애플리케이션)인지 여부를 지정합니다. 기본값은 false입니다.

매개 변수 속성

형식:	PublicClientApplication
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RequiredResourceAccess

이 애플리케이션에 액세스해야 하는 리소스와 각 리소스에 필요한 OAuth 권한 범위 및 애플리케이션 역할 집합을 지정합니다.

필요한 리소스 액세스의 사전 구성은 동의 환경을 구동합니다.

매개 변수 속성

형식:	System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SignInAudience

현재 애플리케이션에 대해 지원되는 Microsoft 계정을 지정합니다.

매개 변수 속성

형식:	System.String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Tags

애플리케이션을 범주화하고 식별하는 데 사용할 수 있는 사용자 지정 문자열입니다.

매개 변수 속성

형식:	System.Collections.Generic.List`1[System.String]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-TokenEncryptionKeyId

keyCredentials 컬렉션에서 공개 키의 keyId를 지정합니다.

구성된 경우 Microsoft Entra ID는 이 속성이 가리키는 키를 사용하여 내보내는 모든 토큰을 암호화합니다.

로그인한 사용자에게 토큰을 사용하려면 먼저 암호화된 토큰을 수신하는 애플리케이션 코드가 일치하는 프라이빗 키를 사용하여 토큰 암호를 해독해야만 합니다.

매개 변수 속성

형식:	System.String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Web

웹 애플리케이션에 대한 설정을 지정합니다.

매개 변수 속성

형식:	WebApplication
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

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

피드백

이 페이지가 도움이 되었나요?