다음을 통해 공유

Set-MsolServicePrincipal

  • 참조
모듈:
MSOnline

Microsoft Azure Active Directory에서 서비스 주체를 업데이트합니다.

구문

Set-MsolServicePrincipal
   [-ObjectId <Guid>]
   [-AppPrincipalId <Guid>]
   [-DisplayName <String>]
   [-ServicePrincipalNames <String[]>]
   [-AccountEnabled <Boolean>]
   [-Addresses <RedirectUri[]>]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Set-MsolServicePrincipal cmdlet은 Microsoft Azure Active Directory의 서비스 주체를 업데이트합니다. 이 cmdlet은 표시 이름을 업데이트하고, 위임에 대해 신뢰할 수 있는 서비스 보안 주체를 사용하거나 사용하지 않도록 설정하고, SPN(서비스 사용자 이름) 또는 주소를 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다.

예제

예제 1: 서비스 주체의 속성 변경

PS C:\> $AppId = (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").AppPrincipalId
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -DisplayName "My Super Application" -ServicePrincipalNames @("MyApp/myapp.com", "MyApp/mysuperapp.com")

이 명령은 지정된 서비스 주체의 속성을 업데이트합니다. 이 예제에서는 표시 이름 및 SPN에 대한 업데이트를 지정합니다. 이 경우 이전 설정을 덮어씁니다.

예제 2: 서비스 주체의 주소 변경

PS C:\> $a = @()
PS C:\> $a = $a + (Get-MsolServicePrincipal -ServicePrincipalName "MyApp").Addresses
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp1.com")
PS C:\> $a = $a + (New-MsolServicePrincipalAddresses -Value "myApp2.com")
PS C:\> Set-MsolServicePrincipal -AppPrincipalId $AppId -Addresses $a

이 명령은 서비스 주체의 주소를 업데이트합니다. 이 예제에서는 New-MsolServicePrincipalAddresses cmdlet을 사용하여 이전에 만든 기존 주소("myApp1.com", "myApp2.com")가 서비스 주체와 연결됩니다.

매개 변수

-AccountEnabled

이 속성은 나중에 사용할 수 있도록 예약됩니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Addresses

기존 목록을 업데이트하고 덮어쓸 주소 목록을 지정합니다. 이 매개 변수를 지정하지 않으면 기존 속성이 업데이트되지 않습니다. 빈 목록을 지정하면 기존 주소가 지워집니다. New-MsolServicePrincipalAddress cmdlet을 사용하여 주소 목록 개체를 만들 수 있습니다.

형식:RedirectUri[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-AppPrincipalId

업데이트할 서비스 주체와 연결된 고유한 애플리케이션 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DisplayName

서비스 주체의 표시 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ObjectId

업데이트할 서비스 주체의 고유 개체 ID를 지정합니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServicePrincipalNames

기존 을 업데이트하고 덮어쓸 SPN 목록을 지정합니다. 이 매개 변수를 지정하지 않으면 기존 속성이 업데이트되지 않습니다. 빈 목록을 지정하면 서비스 주체의 AppId 값이 포함된 SPN을 제외하고 기존 SPN이 지워집니다. SPN은 다음 형식 중 하나를 사용해야 합니다.

  • appName
  • appName/hostname
  • 유효한 URL
형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False