コマンド (MSI/EXE)

Installation

手順 1: .NET Windows ランタイムをインストールする

まだインストールしていない場合は、.NET 8 デスクトップ ランタイムの最新バージョンをインストールします。 これは、Microsoft Store Developer CLI を実行するための要件です。

これをインストールする最も簡単な方法は、 winget を使用する方法です。

winget install Microsoft.DotNet.DesktopRuntime.8

手順 2: Windowsに Microsoft Store Developer CLI をインストールする

Microsoft Store Developer CLI は、Microsoft Store からダウンロードできます。 または、 winget を使用できます。

winget install "Microsoft Store Developer CLI"

手順 1: macOS ランタイム.NETインストールする

まだインストールしていない場合は、.NET 8 Runtime の最新バージョンをインストールします。 これは、Microsoft Store Developer CLI を実行するための要件です。

手順 2: macOS に Microsoft Store Developer CLI をインストールする

特定のアーキテクチャ (x64 または Arm64) の macOS .tar.gzは、Microsoft Store Developer CLI リリース ページからダウンロードできます。 ダウンロードしたら、アーカイブを抽出して 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: Linux ランタイム.NETインストールする

まだインストールしていない場合は、.NET 8 Runtime の最新バージョンをインストールします。 これは、Microsoft Store Developer CLI を実行するための要件です。

手順 2: Microsoft Store Developer CLI を Linux にインストールする

特定のアーキテクチャ (x64 または Arm64) の Linux .tar.gzは、Microsoft Store Developer CLI リリース ページからダウンロードできます。 ダウンロードしたら、アーカイブを抽出して 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

Info コマンド

既存の構成を印刷します。

Usage

msstore info

オプション

Option Description
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

コマンドの再構成

Microsoft Store Developer CLI を再構成します。 クライアント シークレットまたは証明書を指定できます。 証明書は、拇印を使用するか、ファイル パスを指定して (パスワードの有無にかかわらず) 指定できます。

Usage

msstore reconfigure

オプション

Option Description
-t、--tenantId 使用するテナント ID を指定します。
-s 、--sellerId 使用する販売者 ID を指定します。
-c、--clientId 使用するクライアント ID を指定します。
-cs、--clientSecret 使用するクライアント シークレットを指定します。
-ct、--certificateThumbprint 使用する証明書の拇印を指定します。
-cfp、--certificateFilePath 使用する証明書ファイルのパスを指定します。
-cp、--certificatePassword 使用する証明書パスワードを指定します。
--リセット 最初からやり直さずに、資格情報のみをリセットします。
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

設定コマンド

Microsoft Store Developer CLI の設定を変更します。

Usage

msstore settings

オプション

Option Description
-t、--enableTelemetry テレメトリを有効にする (空/true) または無効にする (false)。
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

SetPDN 副コマンド

Publisher表示名プロパティを設定します。

Usage

msstore settings setpdn <publisherDisplayName>

論争

Argument Description
publisherDisplayName グローバルに設定されるPublisher表示名プロパティ。

オプション

Option Description
-?, -h、 --help ヘルプと使用状況の情報を表示します。

提出コマンド

サブコマンド Description
地位 申請の状態を取得します。
取得する 特定の申請のメタデータとパッケージ情報を取得します。
getListingAssets 特定の申請の一覧資産を取得します。
updateMetadata 特定の申請のメタデータを更新します。
更新 特定の申請のパッケージ情報を更新します。
投票 申請の状態をポーリングします。
publish 特定の申請を公開します。

申請 - 状態 - 使用状況

msstore submission status <productId>

論争

Argument Description
productId パートナーセンターID

オプション

Option Description
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

申請 - 取得 - 使用状況

msstore submission get <productId>

論争

Argument Description
productId パートナーセンターID

オプション

Option Description
-l、--language 取得する言語を選択します。 既定: 英語
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

提出 - GetListingAssets - 使用

msstore submission getListingAssets <productId>

論争

Argument Description
productId パートナーセンターID

オプション

Option Description
-l、--language 取得する言語を選択します。 既定: 英語
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

提出 - メタデータ更新 - 使用法

msstore submission updateMetadata <productId> <metadata>

論争

Argument Description
productId パートナーセンターID
metadata 更新された JSON メタデータ表現。

オプション

Option Description
-s、--skipInitialPolling アクションを実行する前に、最初のポーリングをスキップします。 [既定値: False]
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

申請 - 更新 - 使用状況

msstore submission update <productId> <package>

論争

Argument Description
productId パートナーセンターID
package アプリ パッケージの更新された JSON 表現。

オプション

Option Description
-s、--skipInitialPolling アクションを実行する前に、最初のポーリングをスキップします。 [既定値: False]
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

ヒント

submission getを呼び出す前に、submission updateを使用して現在のパッケージ JSON を取得します。 これにより、正しい構造と現在の値を使用できます。 たとえば、PowerShell で以下を実行します。

# Step 1: Retrieve the current submission package JSON
msstore submission get <productId> | Out-File -Encoding utf8 package.json

# Step 2: Edit package.json to reflect your changes (for example, a new installer URL)

# Step 3: Pass the updated JSON to submission update
$updatedPackage = Get-Content -Raw package.json
msstore submission update <productId> $updatedPackage

詳細については、「 GitHub Actions

提出 - 投票 - 使用状況

msstore submission poll <productId>

論争

Argument Description
productId パートナーセンターID

オプション

Option Description
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

提出 - 公開 - 使用

msstore submission publish <productId>

論争

Argument Description
productId パートナーセンターID

オプション

Option Description
-v、--verbose 詳細な出力を表示します。
-?, -h、 --help ヘルプと使用状況の情報を表示します。

CI/CD 環境

Microsoft Store Developer CLI (プレビュー) では、CI/CD 環境での実行がサポートされています。 つまり、CI/CD パイプラインで Microsoft Store Developer CLI (プレビュー) を使用して、アプリケーションをMicrosoft Storeに自動的に発行することができます。

これを実現するための最初の手順として、CI/CD 環境に Microsoft Store Developer CLI (プレビュー) をインストールします。 これを行う方法については、 こちらをご覧ください

Microsoft Store Developer CLI (プレビュー) をインストールしたら、コマンドを実行できるように環境を構成する必要があります。 これを行うには、パートナー センター アカウント (msstore reconfigureSellerIdClientId) を識別する特定のパラメーターで コマンドを実行します。 また、 ClientSecret または 証明書を指定する必要があります。

これらの資格情報は CI/CD パイプラインのログに表示されるため、非表示にすることが非常に重要です。 これを行うには、 シークレットを使用します。 各 CI/CD パイプライン システムには、これらのシークレットの名前が異なります。 たとえば、Azure DevOpsそれらを Secret Variables と呼びますが、GitHub Action はそれらを Encrypted Secrets と呼びます。 各パラメーター (TenantId、SellerIdClientIdClientSecret または証明書) に 1 つのシークレットを作成し、 コマンドを使用して環境をセットアップします。 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

- 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 Developer CLI (プレビュー) が、指定された資格情報を使用するように構成されます。 CI/CD パイプラインで Microsoft Store Developer CLI (プレビュー) を使用できるようになりました。