Share via

Import-CMAADServerApplication

  • 참조
모듈:
ConfigurationManager

Configuration Manager Microsoft Entra 서버 앱 정의를 만듭니다.

Syntax

Import-CMAADServerApplication
      [-AppIdUri <Uri>]
      [-AppName] <String>
      [-AzureEnvironmentOption <AzureEnvironment>]
      [-ClientId] <String>
      [-SecretKey] <SecureString>
      [-SecretKeyExpiry] <DateTime>
      [-TenantId] <String>
      [-TenantName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

이 cmdlet을 사용하여 Microsoft Entra ID에서 서버 앱을 가져오고 Configuration Manager 사이트에 대해 정의합니다. Azure 관리자가 이미 Microsoft Entra ID로 앱을 만들었다고 가정합니다. Microsoft Entra ID에서 이 앱을 웹앱 등록이라고 합니다.

이 cmdlet을 사용하여 CMG(클라우드 관리 게이트웨이)를 만드는 방법에 대한 자세한 내용은 2010 릴리스 정보: 클라우드 관리 게이트웨이를 참조하세요.

Configuration Manager Microsoft Entra 앱에 대한 자세한 내용은 Azure 서비스 구성을 참조하세요.

참고

이 cmdlet은 다른 Azure 서비스에서 작동할 수 있지만 CMG(클라우드 관리 게이트웨이)를 지원하기 위해 클라우드 관리 연결로만 테스트됩니다.

예제

예 1

이 예제에서 첫 번째 명령은 에 대한 datetime 변수를 11/16/2021만듭니다. 두 번째 명령은 제공된 세부 정보를 사용하여 서버 앱을 가져올 때 이 날짜 변수를 비밀 키 만료 날짜로 사용합니다.

$date = [datetime]::parseexact("11/16/2021", 'MM/dd/yyyy', $null)

Import-CMAADServerApplication -TenantName "Contoso" -TenantId "05a349fa-298a-4427-8771-9efcdb73431e" -AppName "CmgServerApp" -ClientId "7078946d-fc1c-43b7-8dee-dd6e6b00d783" -SecretKey "1uXGR^!0@Cjas6qI*J02ZeS&&zY19^hC*9" -SecretKeyExpiry $date

매개 변수

-AppIdUri

Microsoft Entra 관리 센터에서 앱 등록 항목의 애플리케이션 ID URI를 지정합니다. 이 값은 Microsoft Entra 테넌트에서 고유해야 합니다. Configuration Manager 클라이언트가 서비스에 대한 액세스를 요청하는 데 사용하는 액세스 토큰에 있습니다. 형식은 다음과 유사합니다. https://ConfigMgrService.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppName

앱의 이름을 지정합니다. 이 값은 앱 등록의 표시 이름입니다.

Type:String
Aliases:ApplicationName
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AzureEnvironmentOption

이 앱 등록이 글로벌 Azure 클라우드() 또는 Azure Government 클라우드(AzurePublicCloudAzureUSGovernmentCloud)에 있는지 여부를 지정합니다.

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientId

앱 등록의 애플리케이션(클라이언트) ID 값을 Microsoft Entra ID로 지정합니다. 형식은 표준 GUID입니다.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecretKey

Azure Portal 복사한 대로 이 앱의 비밀 키를 지정합니다. Microsoft Entra ID에 앱을 등록할 때 비밀 키를 복사했습니다.

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecretKeyExpiry

SecretKey가 만료되는 날짜를 지정합니다. 앱의 비밀 키를 Microsoft Entra ID로 만들 때 이 값을 구성합니다.

Type:DateTime
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

Microsoft Entra 테넌트 GUID를 지정합니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantName

Microsoft Entra 테넌트 이름을 지정합니다.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

IResultObject