次の方法で共有

コマンド (MSI/EXE)

Installation

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

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

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

winget install Microsoft.DotNet.DesktopRuntime.8

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

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

winget install "Microsoft Store Developer CLI"

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

まだインストールしていない場合は、最新バージョンの .NET 8 ランタイムをインストールします。 これは、Microsoft Store 開発者 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: .NET Linux ランタイムをインストールする

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

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

特定のアーキテクチャ (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 ヘルプと使用状況の情報を表示します。

Settings コマンド

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

Usage

msstore settings

オプション

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

SetPDN 副コマンド

Publisher Display Name プロパティを設定します。

Usage

msstore settings setpdn <publisherDisplayName>

論争

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

オプション

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 取得する言語を選択します。 [デフォルト: en]
-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 ヘルプと使用状況の情報を表示します。

提出 - 投票 - 使用状況

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 reconfigure、SellerId、ClientId) を識別する特定のパラメーターで コマンドを実行します。 また、 ClientSecret または 証明書を指定する必要があります。

これらの資格情報は CI/CD パイプラインのログに表示されるため、非表示にすることが非常に重要です。 これを行うには、 シークレットを使用します。 各 CI/CD パイプライン システムには、これらのシークレットの名前が異なります。 たとえば、Azure DevOps はシークレット 変数を呼び出しますが、GitHub アクションでは 暗号化されたシークレットを呼び出します。 各パラメーター (TenantId、SellerId、ClientId、ClientSecret または証明書) に 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 (プレビュー) を使用できるようになりました。

  • Last updated on