Import-CMAADServerApplication
Configuration Manager에서 Microsoft Entra 서버 앱 정의를 만듭니다.
구문
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.
형식: | Uri |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AppName
앱의 이름을 지정합니다. 이 값은 앱 등록의 표시 이름입니다.
형식: | String |
별칭: | ApplicationName |
Position: | 2 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AzureEnvironmentOption
이 앱 등록이 글로벌 Azure 클라우드() 또는 Azure Government 클라우드(AzurePublicCloud
AzureUSGovernmentCloud
)에 있는지 여부를 지정합니다.
형식: | AzureEnvironment |
허용되는 값: | AzurePublicCloud, AzureUSGovernmentCloud |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ClientId
Microsoft Entra ID에서 앱 등록의 애플리케이션(클라이언트) ID 값을 지정합니다. 형식은 표준 GUID입니다.
형식: | String |
Position: | 3 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecretKey
Azure Portal에서 복사한 대로 이 앱의 비밀 키를 지정합니다. Microsoft Entra ID에 앱을 등록할 때 비밀 키를 복사했습니다.
형식: | SecureString |
Position: | 4 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecretKeyExpiry
SecretKey가 만료되는 날짜를 지정합니다. Microsoft Entra ID에서 앱에 대한 비밀 키를 만들 때 이 값을 구성합니다.
형식: | DateTime |
Position: | 5 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-TenantId
Microsoft Entra 테넌트 GUID를 지정합니다.
형식: | String |
Position: | 1 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-TenantName
Microsoft Entra 테넌트 이름을 지정합니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
None
출력
IResultObject