다음을 통해 공유

New-AzureADServicePrincipal

모듈:
AzureAD Module

서비스 주체를 만듭니다.

구문

Default (기본값) 

New-AzureADServicePrincipal
    [-AccountEnabled <String>]
    [-AlternativeNames <System.Collections.Generic.List`1[System.String]>]
    -AppId <String>
    [-AppRoleAssignmentRequired <Boolean>]
    [-DisplayName <String>]
    [-ErrorUrl <String>]
    [-Homepage <String>]
    [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
    [-LogoutUrl <String>]
    [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
    [-PublisherName <String>]
    [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
    [-SamlMetadataUrl <String>]
    [-ServicePrincipalNames <System.Collections.Generic.List`1[System.String]>]
    [-ServicePrincipalType <String>]
    [-Tags <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

예제

예제 1: 서비스 주체 만들기

PS C:\>New-AzureADServicePrincipal -AccountEnabled $true -AppId $MyApp.AppId -AppRoleAssignmentRequired $true -DisplayName $App -Tags {WindowsAzureActiveDirectoryIntegratedApp}

이 명령은 서비스 주체를 만듭니다. "-Tags {WindowsAzureActiveDirectoryIntegratedApp}" 태그는 이 서비스 주체가 관리 포털의 통합 응용 프로그램 목록에 표시되도록 하는 데 사용됩니다.

매개 변수

-AccountEnabled

서비스 주체 계정을 사용하는 경우 true입니다. 그렇지 않으면 false입니다.

매개 변수 속성

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

매개 변수 집합

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

-AlternativeNames

이 서비스 주체의 대체 이름

매개 변수 속성

형식:

List<T>[String]

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

매개 변수 집합

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

-AppId

연결된 애플리케이션(해당 appId 속성)의 고유 식별자입니다.

매개 변수 속성

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

매개 변수 집합

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

-AppRoleAssignmentRequired

응용 프로그램 역할 할당이 필요한지 여부를 나타냅니다.

매개 변수 속성

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

매개 변수 집합

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

-DisplayName

표시 이름을 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-ErrorUrl

오류 URL을 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-Homepage

홈 페이지를 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-KeyCredentials

서비스 주체와 연결된 키 자격 증명의 컬렉션입니다.

매개 변수 속성

형식:

List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]

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

매개 변수 집합

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

-LogoutUrl

로그아웃 URL을 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-PasswordCredentials

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

매개 변수 속성

형식:

List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]

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

매개 변수 집합

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

-PublisherName

게시자 이름을 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-ReplyUrls

사용자 토큰이 연결된 애플리케이션에 로그인하기 위해 전송되는 URL 또는 OAuth 2.0 권한 부여 코드 및 액세스 토큰이 연결된 애플리케이션에 대해 전송되는 리디렉션 URI입니다.

매개 변수 속성

형식:

List<T>[String]

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

매개 변수 집합

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

-SamlMetadataUrl

SAML 메타데이터의 URL

매개 변수 속성

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

매개 변수 집합

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

-ServicePrincipalNames

서비스 주체 이름의 배열을 지정합니다. identifierURIs 컬렉션과 애플리케이션의 appId 속성을 기반으로 이러한 URI는 애플리케이션의 서비스 주체를 참조하는 데 사용됩니다. 클라이언트는 이를 사용하여 다음을 수행합니다.

  • Azure 클래식 포털의 "다른 애플리케이션에 대한 권한"을 통해 requiredResourceAccess를 채웁니다. - 클레임에 반환된 URI인 액세스 토큰을 획득할 리소스 URI를 지정합니다.

매개 변수 속성

형식:

List<T>[String]

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

매개 변수 집합

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

-ServicePrincipalType

서비스 주체의 형식

매개 변수 속성

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

매개 변수 집합

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

-Tags

이 서비스 주체에 연결된 태그입니다.

이 서비스 주체가 관리 포털의 모든 응용 프로그램 목록에 표시되도록 하려면 이 값을 {WindowsAzureActiveDirectoryIntegratedApp}으로 설정해야 합니다.

매개 변수 속성

형식:

List<T>[String]

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를 참조하세요.

참고

Microsoft Graph PowerShell로의 New-AzureADServicePrincipal에 대한 마이그레이션 가이드 를 참조하세요.