MSCommerce PowerShell 모듈에 AllowSelfServicePurchase 사용

MSCommerce PowerShell 모듈은 이제 PowerShell 갤러리 사용할 수 있습니다. 이 모듈에는 Organization 사용자가 Microsoft의 셀프 서비스 구매 또는 타사 제품을 선택할 수 있는지 여부를 제어할 수 있는 AllowSelfServicePurchase에 대한 PolicyID 매개 변수 값이 포함되어 있습니다.

MSCommerce PowerShell 모듈을 사용하여 다음을 수행할 수 있습니다.

• AllowSelfServicePurchase 매개 변수 값의 기본 상태 보기(사용 여부, 사용 안 함 또는 결제 방법 없이 평가판 허용 여부)
• 적용 가능한 제품 목록 및 셀프 서비스 구매를 사용할 수 있는지 여부, 사용 안 함 또는 결제 방법 없이 평가판 허용 여부 보기
• 특정 제품의 현재 설정을 보거나 수정하여 사용하거나 사용하지 않도록 설정합니다.
• 결제 방법 없이 평가판 설정 보기 또는 수정

요구 사항

MSCommerce PowerShell 모듈을 사용하려면 다음이 필요합니다.

• Windows 10 이상 운영 체제.
• PowerShell 5 이하. 현재 PowerShell 6.x/7.x는 이 모듈에서 지원되지 않습니다.
• MSCommerce 제품 정책을 변경하는 테넌트용 전역 또는 청구 관리자 역할입니다.
• MSCommerce 제품 정책의 읽기 전용 목록을 볼 테넌트용 전역 읽기 권한자 역할입니다.

MSCommerce PowerShell 모듈 설치

MSCommerce PowerShell 모듈을 Windows 10 디바이스에 한 번 설치한 다음 시작하는 각 PowerShell 세션으로 가져옵니다. PowerShell 갤러리MSCommerce PowerShell 모듈을 다운로드합니다.

PowerShellGet을 사용하여 MSCommerce PowerShell 모듈을 설치하려면 다음 명령을 실행합니다.

Install-Module -Name MSCommerce

MSCommerce를 PowerShell 세션으로 가져오기

Windows 10 디바이스에 모듈을 설치한 후 시작하는 각 PowerShell 세션으로 모듈을 가져옵니다. PowerShell 세션으로 가져오려면 다음 명령을 실행합니다.

Import-Module -Name MSCommerce

자격 증명을 사용하여 MSCommerce에 연결

자격 증명을 사용하여 PowerShell 모듈에 연결하려면 다음 명령을 실행합니다.

Connect-MSCommerce

이 명령은 현재 PowerShell 세션을 Microsoft Entra 테넌트로 연결합니다. 이 명령은 연결하려는 테넌트에서 사용자 이름과 암호를 묻는 메시지를 표시합니다. 자격 증명에 대해 다단계 인증을 사용하도록 설정한 경우 대화형 옵션을 사용하여 로그인합니다.

AllowSelfServicePurchase에 대한 세부 정보 보기

AllowSelfServicePurchase 매개 변수 값 및 기본 상태 대한 설명을 보려면 organization 따라 다음 명령을 실행합니다.

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

셀프 서비스 구매 제품 및 해당 상태 목록 보기

사용 가능한 모든 셀프 서비스 구매 제품 목록과 각 제품의 상태 보려면 다음 명령을 실행합니다.

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

다음 표에서는 사용 가능한 제품 및 해당 ProductId를 나열합니다. 또한 평가판을 사용할 수 있고 결제 방법이 필요하지 않은 제품을 나타냅니다. 해당하는 경우 다른 모든 평가판에는 결제 방법이 필요합니다. 결제 방법이 활성화되지 않은 평가판이 있는 제품의 경우 평가판을 사용하도록 설정하는 동시에 제품을 구매할 수 있는 기능을 사용하지 않도록 설정할 수 있습니다. 샘플 명령은 AllowSelfServicePurchase에 대한 상태 보기 또는 설정을 참조하세요.

제품	Productid	결제 방법이 없는 평가판이 활성화되어 있나요?
Clipchamp Premium	CFQ7TTC0N8SS	아니오
사용자당 Power Apps*	CFQ7TTC0LH2H	아니오
사용자당 Power Automate*	CFQ7TTC0LH3L	아니오
Power Automate RPA*	CFQ7TTC0LSGZ	아니오
Power BI Premium(독립 실행형)*	CFQ7TTC0H6RP	아니오
Power BI Pro*	CFQ7TTC0H9MP	아니오
Project 플랜 1*	CFQ7TTC0HDB1	예
Project 플랜 3*	CFQ7TTC0HDB0	아니오
Teams 예비	CFQ7TTC0J1FV	예
Teams Premium 소개 가격 책정	CFQ7TTC0RM8K	예
Visio 플랜 1*	CFQ7TTC0HD33	예
Visio 플랜 2*	CFQ7TTC0HD32	아니오
Viva Goals(셀프 서비스 평가판에만 해당)	CFQ7TTC0PW0V	예
Windows 365 Enterprise	CFQ7TTC0HHS9	아니오
Windows 365 Business	CFQ7TTC0J203	아니오
Windows 하이브리드 혜택 Windows 365 Business	CFQ7TTC0HX99	아니오
Microsoft 365 F3	CFQ7TTC0LH05	아니오
Microsoft Purview 검색	CFQ7TTC0N8SL	예

*이러한 ID가 변경되었습니다. 이전에 이전 ID를 사용하여 제품을 차단한 경우 새 ID를 사용하여 제품이 자동으로 차단됩니다. 다른 작업은 필요하지 않습니다.

셀프 서비스 구매 "타사 제품 유형" 및 해당 상태 목록 보기

사용 가능한 모든 셀프 서비스 구매 타사 제품 유형 및 각 제품의 상태 목록을 보려면 다음 명령을 실행합니다.

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

다음 표에는 사용 가능한 타사 제품 유형이 나와 있습니다. 이러한 제품 유형은 셀프 서비스 구매에 대해 사용하거나 사용하지 않도록 설정할 수 있습니다.

제품 유형	Id
Software as a Service	SaaS
Power BI 시각적 개체	POWERBIVISUALS
dataverse 앱 Dynamics 365	DYNAMICSCE
Dynamics 365 Business Central	DYNAMICSBC

AllowSelfServicePurchase에 대한 상태 보거나 설정합니다.

AllowSelfServicePurchase에 대한 Value 매개 변수를 설정하여 사용자가 셀프 서비스 구매를 허용하거나 차단할 수 있습니다. OnlyTrialsWithoutPaymentMethod 값을 사용하여 사용자가 결제 필요 평가판이 없는 제품을 사용해 볼 수 있습니다. 위의 제품 목록을 참조하여 이러한 평가판을 사용하도록 설정한 제품을 확인합니다. 사용자는 AllowSelfServicePurchase를 사용하도록 설정한 경우에만 평가판이 끝난 후에만 제품을 구입할 수 있습니다.

참고

AllowSelfServicePurchase 또는 OnlyTrialsWithoutPaymentMethod의 값을 변경하면 해당 시점부터 지정된 제품에 대한 평가판 또는 구매에만 영향을 줍니다. 지정된 제품에 대한 기존 평가판 또는 구매는 영향을 받지 않습니다.

다음 표에서는 Value 매개 변수에 대한 설정을 설명합니다.

설정	영향
사용	사용자는 셀프 서비스 구매를 수행하고 제품에 대한 평가판을 취득할 수 있습니다.
OnlyTrialsWithoutPaymentMethod	사용자는 셀프 서비스 구매를 할 수 없지만 결제 방법을 추가할 필요가 없는 제품에 대한 평가판을 획득할 수 있습니다. 평가판이 만료되면 사용자는 유료 버전의 제품을 구입할 수 없습니다.
사용 안 함	사용자는 셀프 서비스 구매를 하거나 제품에 대한 평가판을 취득할 수 없습니다.

특정 제품에 대한 정책 설정을 얻으려면 다음 명령을 실행합니다.

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

특정 제품에 대한 정책 설정을 사용하도록 설정하려면 다음 명령을 실행합니다.

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "Enabled"

특정 제품에 대한 정책 설정을 사용하지 않도록 설정하려면 다음 명령을 실행합니다.

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "Disabled"

사용자가 결제 방법 없이 특정 제품을 사용해 보도록 허용하려면 다음 명령을 실행합니다.

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "OnlyTrialsWithoutPaymentMethod" 

특정 타사 제품 유형에 대한 정책 설정을 얻으려면 다음 명령을 실행합니다.

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

특정 타사 제품 유형에 대해 정책 설정을 사용하도록 설정하려면 다음 명령을 실행합니다.

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Enabled"

특정 타사 제품 유형에 대한 정책 설정을 사용하지 않도록 설정하려면 다음 명령을 실행합니다.

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Disabled"

AllowSelfServicePurchase를 사용하지 않도록 설정하는 예제 스크립트

다음 예제에서는 MSCommerce 모듈을 가져오고, 계정으로 로그인하고, 사용자당 Power Automate용 ProductId 를 가져온 다음, 해당 제품에 대해 AllowSelfServicePurchase 를 사용하지 않도록 설정하는 방법을 안내합니다.

Import-Module -Name MSCommerce
Connect-MSCommerce #sign-in with your global or billing administrator account when prompted
$product = Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase | where {$_.ProductName -match 'Power Automate per user'}
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product.ProductID -Value "Disabled"

제품에 여러 값이 있는 경우 다음 예제와 같이 각 값에 대해 개별적으로 명령을 실행할 수 있습니다.

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[0].ProductID -Value "Disabled"
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[1].ProductID -Value "Disabled"
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType SaaS -Value "Disabled"

문제 해결

문제

다음 오류 메시지가 표시됩니다.

HandleError: PolicyId 'AllowSelfServicePurchase'로 정책을 검색하지 못했습니다. ErrorMessage - 기본 연결이 닫혔습니다. 전송 시 예기치 않은 오류가 발생했습니다.

이는 이전 버전의 TLS(전송 계층 보안)로 인해 발생할 수 있습니다. 이 서비스에 연결할 때 TLS 1.2 이상을 사용해야 합니다.

해결 방법

TLS 1.2로 업그레이드합니다. 다음 구문은 TLS1.2를 허용하도록 ServicePointManager 보안 프로토콜을 업데이트합니다.

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

자세한 내용은 TLS 1.2를 사용하도록 설정하는 방법을 참조하세요.

관련 콘텐츠

셀프 서비스 구매 관리(관리)(문서)
셀프 서비스 구매 FAQ (문서)