命令（MSIX）

安裝

winget install Microsoft.DotNet.DesktopRuntime.8

winget install "Microsoft Store Developer CLI"

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 install microsoft/msstore-cli/msstore-cli

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 install microsoft/msstore-cli/msstore-cli

Info 命令

列印現有的組態。

Usage

msstore info

選項

Reconfigure 命令

重新設定 Microsoft Store 開發人員 CLI。 您可以提供客戶端密碼或憑證。 憑證可以透過其指紋或提供檔案路徑來提供（含或不含密碼）。

Usage

msstore reconfigure

選項

Settings 命令

變更 Microsoft Store 開發人員 CLI 的設定。

Usage

msstore settings

選項

SetPDN 子命令

設定 init 命令所使用的發行者顯示名稱屬性。

Usage

msstore settings setpdn <publisherDisplayName>

引數

選項

應用程式命令

應用程式 - 清單 - 使用情況

msstore apps list

選項

應用程式 - 獲取 - 使用情況

msstore apps get <productId>

引數

選項

提交項目命令

提交 - 狀態 - 使用情況

msstore submission status <productId>

引數

選項

提交 - 獲取 - 用法

msstore submission get <productId>

引數

選項

提交作業 - GetListingAssets - 使用方式

msstore submission getListingAssets <productId>

引數

選項

提交 - 更新中繼資料 - 使用方式

msstore submission updateMetadata <productId> <metadata>

引數

選項

提交 - 投票 - 使用方式

msstore submission poll <productId>

引數

選項

提交 - 發佈 - 使用方式

msstore submission publish <productId>

引數

選項

提交 - 刪除 - 使用方式

msstore submission delete <productId>

引數

選項

Init 命令

init 命令可協助您設定應用程式以發佈至 Microsoft Store。 目前支援下列應用程式類型：

• Windows 應用程式 SDK/WinUI 3
• UWP
• .NET MAUI
• 撲動
• 電子
• React Native 桌面版
• PWA

使用範例

Windows 應用程式 SDK/WinUI 3

msstore init "C:\path\to\winui3_app"

UWP

msstore init "C:\path\to\uwp_app"

.NET MAUI

msstore init "C:\path\to\maui_app"

撲動

msstore init "C:\path\to\flutter_app"

電子

msstore init "C:\path\to\electron_app"

React Native 桌面版

msstore init "C:\path\to\react_native_app"

PWA

msstore init https://contoso.com --output .

引數

選項

Package 命令

協助您將 Microsoft Store 應用程式封裝為 MSIX。

使用範例

Windows 應用程式 SDK/WinUI 3

msstore package "C:\path\to\winui3_app"

UWP

msstore package "C:\path\to\uwp_app"

.NET MAUI

msstore package "C:\path\to\maui_app"

撲動

msstore package "C:\path\to\flutter_app"

電子

msstore package "C:\path\to\electron_app"

React Native 桌面版

msstore package "C:\path\to\react_native_app"

PWA

msstore package "C:\path\to\pwa_app"

引數

選項

Publish 命令

將您的應用程式發佈至 Microsoft Store。

使用範例

Windows 應用程式 SDK/WinUI 3

msstore publish "C:\path\to\winui3_app"

UWP

msstore publish "C:\path\to\uwp_app"

.NET MAUI

msstore publish "C:\path\to\maui_app"

撲動

msstore publish "C:\path\to\flutter_app"

電子

msstore publish "C:\path\to\electron_app"

React Native 桌面版

msstore publish "C:\path\to\react_native_app"

PWA

msstore publish "C:\path\to\pwa_app"

引數

選項

飛行指揮部

航班 - 列表 - 使用情況

msstore flights list <productId>

引數

選項

航班 - 獲取 - 使用情況

msstore flights get <productId> <flightId>

引數

選項

航班 - 刪除 - 使用情況

msstore flights delete <productId> <flightId>

引數

選項

航班 - 創建 - 使用

msstore flights create <productId> <friendlyName> --group-ids <group-ids>

引數

選項

航班 - 提交

航班 - 提交 - 取得 - 使用

msstore flights submission get <productId> <flightId>

引數

選項

航班 - 提交 - 刪除 - 使用

msstore flights submission delete <productId> <flightId>

引數

選項

航班 - 提交 - 更新 - 使用情況

msstore flights submission update <productId> <flightId> <product>

引數

選項

航班 - 提交 - 發佈 - 使用

msstore flights publish <productId> <flightId>

引數

選項

航班 - 提交 - 投票 - 使用情況

msstore flights poll <productId> <flightId>

引數

選項

航班 - 提交 - 狀態 - 使用情況

msstore flights status <productId> <flightId>

引數

選項

航班 - 提交 - 推出

航班 - 提交 - 推出 - 取得 - 使用

msstore flights submission rollout get <productId> <flightId>

引數

選項

航班 - 提交 - 推出 - 更新 - 使用

msstore flights submission rollout update <productId> <flightId> <percentage>

引數

選項

航班 - 提交 - 推出 - 停止 - 使用

msstore flights submission rollout halt <productId> <flightId>

引數

選項

飛行記錄 - 提交 - 部署 - 定稿 - 使用

msstore flights submission rollout finalize <productId> <flightId>

引數

選項

CI/CD 環境

Microsoft Store 開發人員 CLI (預覽版) 支援在 CI/CD 環境中執行。 這表示您可以在 CI/CD 管線中使用 Microsoft Store 開發人員 CLI (預覽版)，例如自動將應用程式發佈至 Microsoft Store。

達成此目的的第一個步驟，就是在您的 CI/CD 環境中安裝 Microsoft Store 開發人員 CLI (預覽版)。 您可以在這裡找到執行這項操作的指示。

安裝 Microsoft Store 開發人員 CLI (預覽版) 之後，您必須設定環境才能執行命令。 您可以使用識別合作夥伴中心帳戶的特定參數來執行命令，以執行此命令（msstore reconfigure、SellerId、ClientId）。 您也需要提供 ClientSecret 或 憑證。

這些認證會顯示在 CI/CD 管線的記錄中，因此請務必隱藏起來。 您可以使用密碼來保護認證。 每個 CI/CD 管線系統都使用不同的名稱來代表這些密碼。 例如，Azure DevOps 將其稱為秘密變數，GitHub Action 則稱為加密密碼。 為每個參數建立一個秘密（TenantId、SellerId

例如：

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 開發人員 CLI (預覽版) 會設定為使用所提供的認證。 您現在可以在 CI/CD 管線中使用 Microsoft Store 開發人員 CLI (預覽版)。