다음을 통해 공유

명령(MSI/EXE)

설치

1단계: .NET Windows 런타임 설치

아직 설치하지 않은 경우 최신 버전의 .NET 8 데스크톱 런타임을 설치합니다. Microsoft Store 개발자 CLI를 실행하기 위한 요구 사항입니다.

설치하는 가장 쉬운 방법은 winget을 사용하는 것입니다.

winget install Microsoft.DotNet.DesktopRuntime.8

2단계: Windows에 Microsoft Store 개발자 CLI 설치

Microsoft Store에서 Microsoft Store 개발자 CLI를 다운로드할 수 있습니다. 또는 winget을 사용할 수 있습니다.

winget install "Microsoft Store Developer CLI"

1단계: .NET macOS 런타임 설치

아직 설치하지 않은 경우 최신 버전의 .NET 8 런타임을 설치합니다. Microsoft Store 개발자 CLI를 실행하기 위한 요구 사항입니다.

2단계: macOS에 Microsoft Store 개발자 CLI 설치

Microsoft Store 개발자 CLI 릴리스 페이지에서 특정 아키텍처(x64 또는 Arm64)에 대한 macOS .tar.gz 다운로드할 수 있습니다. 다운로드한 후 보관 파일을 추출하여 원하는 방법으로 PATH에 넣습니다. 예를 들어:

mkdir MSStoreCLI
curl https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-osx-x64.tar.gz -o MSStoreCLI-osx-x64.tar.gz
tar -xvf MSStoreCLI-osx-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

또는 brew를 사용할 수 있습니다.

brew install microsoft/msstore-cli/msstore-cli

1단계: .NET Linux 런타임 설치

아직 설치하지 않은 경우 최신 버전의 .NET 8 런타임을 설치합니다. Microsoft Store 개발자 CLI를 실행하기 위한 요구 사항입니다.

2단계: Linux에 Microsoft Store 개발자 CLI 설치

Microsoft Store 개발자 CLI 릴리스 페이지에서 특정 아키텍처(x64 또는 Arm64)에 대한 Linux .tar.gz 다운로드할 수 있습니다. 다운로드한 후 보관 파일을 추출하여 PATH에 넣습니다. 이 과정은 예를 들어, 본인이 원하는 방식대로 할 수 있습니다.

mkdir MSStoreCLI
wget https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-linux-x64.tar.gz
tar -xvf MSStoreCLI-linux-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

또는 brew를 사용할 수 있습니다.

brew install microsoft/msstore-cli/msstore-cli

정보 명령어

기존 구성을 인쇄합니다.

Usage

msstore info

Options

Option Description
-v, --verbose (상세 출력) 상세 출력을 출력합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

명령 다시 구성

Microsoft Store 개발자 CLI를 재구성합니다. 클라이언트 암호 또는 인증서를 제공할 수 있습니다. 인증서는 지문을 통해 또는 파일 경로(암호 포함 또는 없음)를 제공하여 제공할 수 있습니다.

Usage

msstore reconfigure

Options

Option Description
-t, --tenantId 사용해야 하는 테넌트 ID를 지정합니다.
-s, --sellerId 사용해야 하는 판매자 ID를 지정합니다.
-c, --clientId (클라이언트 ID) 사용해야 하는 클라이언트 ID를 지정합니다.
-cs, --clientSecret 사용해야 하는 클라이언트 비밀을 지정합니다.
-ct, --certificateThumbprint 사용해야 하는 인증서 지문을 지정합니다.
-cfp, --certificateFilePath 사용해야 하는 인증서 파일 경로를 지정합니다.
-cp, --certificatePassword 사용해야 하는 인증서 암호를 지정합니다.
--재설정 다시 시작하지 않고 자격 증명만 다시 설정합니다.
-v, --verbose (자세한 정보 출력) 상세 정보를 출력합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

설정 명령

Microsoft Store 개발자 CLI의 설정을 변경합니다.

Usage

msstore settings

Options

Option Description
-t, --enableTelemetry 원격 분석을 사용(빈/true)하거나 사용하지 않음(false)으로 설정합니다.
-v, --verbose 상세 출력을 출력합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

SetPDN 하위 명령어

게시자 표시 이름 속성을 설정합니다.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName 전역적으로 설정될 게시자 표시 이름 속성입니다.

Options

Option Description
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 명령

서브 명령 Description
상태 제출의 상태를 가져옵니다.
가져오기 특정 제출의 메타데이터 및 패키지 정보를 가져옵니다.
목록자산받기 특정 제출물의 자산 목록을 가져옵니다.
updateMetadata 특정 제출의 메타데이터를 업데이트합니다.
업데이트 특정 제출의 패키지 정보를 업데이트합니다.
투표 제출 상태를 주기적으로 확인합니다.
출판하다 특정 제출을 게시합니다.

제출 - 상태 - 사용량

msstore submission status <productId>

Arguments

Argument Description
productId 파트너 센터 ID입니다.

Options

Option Description
-v, --verbose 상세 출력을 표시합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 - 가져오기 - 사용량

msstore submission get <productId>

Arguments

Argument Description
productId 파트너 센터 ID입니다.

Options

Option Description
-l, --language 검색할 언어를 선택합니다. [default: en]
-v, --verbose (상세 출력) 자세한 출력을 출력합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 - GetListingAssets - 사용량

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId 파트너 센터 ID입니다.

Options

Option Description
-l, --language 검색할 언어를 선택합니다. [default: en]
-v, --verbose (자세한 정보 표시) 자세한 정보 출력을 인쇄합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 - 메타데이터 업데이트 - 사용량

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId 파트너 센터 ID입니다.
metadata 업데이트된 JSON 메타데이터 표현입니다.

Options

Option Description
-s, --skipInitialPolling 작업을 실행하기 전에 초기 폴링을 건너뜁니다. [기본값: False]
-v, --verbose 자세한 정보 출력을 인쇄합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 - 업데이트 - 사용량

msstore submission update <productId> <package>

Arguments

Argument Description
productId 파트너 센터 ID입니다.
package 앱 패키지의 업데이트된 JSON 표현입니다.

Options

Option Description
-s, --skipInitialPolling 작업을 수행하기 전에 초기 폴링 단계를 건너뜁니다. [기본값: False]
-v, --verbose 자세한 정보 출력을 인쇄합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 - 설문 조사 - 사용량

msstore submission poll <productId>

Arguments

Argument Description
productId 파트너 센터 ID입니다.

Options

Option Description
-v, --verbose 자세한 정보 출력을 인쇄합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

제출 - 게시 - 사용

msstore submission publish <productId>

Arguments

Argument Description
productId 파트너 센터 ID입니다.

Options

Option Description
-v, --verbose 자세한 정보 출력을 인쇄합니다.
-?, -h, --help 도움말 및 사용 정보를 표시합니다.

CI/CD 환경

Microsoft Store 개발자 CLI(미리 보기)는 CI/CD 환경에서 실행을 지원합니다. 즉, CI/CD 파이프라인에서 Microsoft Store 개발자 CLI(미리 보기)를 사용하여 애플리케이션을 Microsoft Store에 자동으로 게시할 수 있습니다.

이를 달성하기 위한 첫 번째 단계는 CI/CD 환경에 Microsoft Store 개발자 CLI(미리 보기)를 설치하는 것입니다. 이 작업을 수행하는 방법에 대한 지침은 여기에서 찾을 수 있습니다.

Microsoft Store 개발자 CLI(미리 보기)를 설치한 후 명령을 실행할 수 있도록 환경을 구성해야 합니다. 파트너 센터 계정(msstore reconfigure, ClientId)을 식별하는 특정 매개 변수를 사용하여 명령을 실행 하여 이 작업을 수행할 수 있습니다. 또한 ClientSecret 또는 인증서를 제공해야 합니다.

이러한 자격 증명은 CI/CD 파이프라인의 로그에 표시되므로 숨기는 것이 매우 중요합니다. 비밀을 사용하여 이 작업을 수행할 수 있습니다. 각 CI/CD 파이프라인 시스템에는 이러한 비밀에 대해 서로 다른 이름이 있습니다. 예를 들어 Azure DevOps는 비밀 변수를 호출하지만 GitHub 작업은 암호화된 비밀을 호출합니다. 각 매개 변수(TenantId, SellerId, ClientId 및 ClientSecret 또는 인증서)에 대해 하나의 비밀을 만든 다음, 명령을 사용하여 환경을 설정합니다. reconfigure

다음은 그 예입니다.

Azure DevOps

- task: UseMSStoreCLI@0
  displayName: Setup Microsoft Store Developer CLI
- script: msstore reconfigure --tenantId $(PARTNER_CENTER_TENANT_ID) --sellerId $(PARTNER_CENTER_SELLER_ID) --clientId $(PARTNER_CENTER_CLIENT_ID) --clientSecret $(PARTNER_CENTER_CLIENT_SECRET)
  displayName: Configure Microsoft Store Developer CLI

GitHub Actions (GitHub 액션)

- name: Setup Microsoft Store Developer CLI
  uses: microsoft/microsoft-store-apppublisher@v1.1
- name: Configure Microsoft Store Developer CLI
  run: msstore reconfigure --tenantId ${{ secrets.PARTNER_CENTER_TENANT_ID }} --sellerId ${{ secrets.PARTNER_CENTER_SELLER_ID }} --clientId ${{ secrets.PARTNER_CENTER_CLIENT_ID }} --clientSecret ${{ secrets.PARTNER_CENTER_CLIENT_SECRET }}

이 명령이 실행되면 Microsoft Store 개발자 CLI(미리 보기)가 제공된 자격 증명을 사용하도록 구성됩니다. 이제 CI/CD 파이프라인에서 Microsoft Store 개발자 CLI(미리 보기)를 사용할 수 있습니다.

  • Last updated on