透過社群中樞註冊主控台擴充功能

文章
04/04/2023

主控台擴充功能作者可以貢獻他們寫入社群中樞的延伸模組。社群中樞使用者可以下載擴充功能，並管理其Configuration Manager階層的安裝。透過社群中樞參與擴充功能會取代先前的部署程式。

版本資訊

若要從社群中樞下載主控台擴充功能，您需要下列其中一項：

Configuration Manager的技術預覽版本
Configuration Manager 2103版或更新版本

您可以使用下列版本在本機匯入，以測試您自己簽署的延伸模組：

Configuration Manager的技術預覽版本
Configuration Manager 2103版或更新版本

您可以在本機匯入未簽署的延伸模組。未簽署的延伸模組僅供本機匯入和測試之用。未簽署的延伸模組無法提交至社群中樞。匯入未簽署的擴充功能需要下列其中一個版本：

Technical Preview 2105.2 版或更新版本。
Configuration Manager 2107 版或更新版本

從 2111 版開始，您可以使用 [匯入主控台擴充功能精靈] 匯入已簽署和未簽署的延伸模組。

先決條件

若要在社群中樞註冊主控台擴充功能，Configuration Manager系統管理員下載，您將需要下列必要條件：

符合參與社群中樞的所有必要條件
Configuration Manager具有所有範圍許可權的系統高版權管理員。
準備好發佈之後，驗證簽署 .cab 檔案中的有效承載。您的 .cab 檔案必須包含下列專案：
- 名為的資訊清單檔案 manifest.xml
- 延伸模組的作者和版本必須列在 manifest.xml
- 副檔名的所有相關檔案都必須位於檔案中 .cab
  - 每個檔案都必須列在資訊清單中，並具有正確的名稱和 SHA256 雜湊

建立延伸模組

建立社群中樞的擴充功能與先前的運作方式並無太大差異。不過，不再需要在其各自 %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions 的資料夾中安裝檔案。這是新 manifest.xml 檔案函式的一部分。您仍然可以建立下列專案：

動作
表單
管理類別
Nodes
檢視
使用您選擇的精靈架構，將您自己的自訂精靈整合到Configuration Manager主控台
- 您無法使用現有的Configuration Manager主控台架構來建立精靈。
- 您無法修改或移除現有Configuration Manager精靈中的步驟。

提示

從社群中樞的 GitHub 存放庫，您可以下載范例擴充功能的 cab 檔案。

建立有效的承載 cab 檔案

建立擴充功能的檔案之後，您將建立 manifest.xml 檔案，然後將它們封裝在 authenticode 簽署的 .cab 檔案中。

authenticode 簽署 .cab 檔案中的有效承載。您的 .cab 檔案必須包含下列專案：
- 名為的資訊清單檔案 manifest.xml
- 延伸模組的作者和版本必須列在 manifest.xml
- 副檔名的所有相關檔案都必須位於檔案中 .cab
  - 每個檔案都必須列在資訊清單中，並具有正確的名稱和 SHA256 雜湊

Manifest.xml格式：

<CustomExtensionManifest ExtensionID="{A GUID to identify this extension}" Name="{Name of the extension to be shown in the Console Extension node}" Description="{Description of the extension to be shown in the Console Extension node" Version="{The version of the extension to be shown in the Console Extension node. For example:1.0}" Author="{The author of the extension to be shown in the Console Extension node}">
	<Deployments>
		<ActionExtensionDeployment ParentNode="{the GUID that identify the folder/node you want to place the action under}">
			<FileList>
				<File Name="{The name of the xml file that defines the action. For example: MyAction.xml}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
			</FileList>
		</ActionExtensionDeployment>
		<NodeExtensionDeployment ParentNode="{the GUID that identify the folder you want to place the node under}">
			<FileList>
				<File Name="{The name of the xml file that defines the node. For example: MyNode.xml}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
			</FileList>
		</NodeExtensionDeployment>
		<FormExtensionDeployment>
			<FileList>
				<File Name="{The name of the xml file that defines the form. For example: MyForm.xml}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
				<File Name="{The name of the dll file that defines the form. For example: MyForm.dll}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
			</FileList>
		</FormExtensionDeployment>
		<ManagementClassExtensionDeployment>
			<FileList>
				<File Name="{The name of the xml file that defines the WMI class. For example: MyClass.xml}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
				<File Name="{The name of the dll file that defines the WMI class. For example: MyClass.dll}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
			</FileList>
		</ManagementClassExtensionDeployment>
		<ViewExtensionDeployment>
			<FileList>
				<File Name="{The name of the dll file that defines the view. For example: MyView.dll}">
					<Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
				</File>
			</FileList>
		</ViewExtensionDeployment>
        <CabExtensionDeployment>
            <FileList>
                <File Name="{The name of the cab file to deploy. CabExtensionDeployment is used when your payload cab file contains a cab within it that needs to be deployed.  For example: MyCab.cab}">
                    <Hash Algorithm="sha256">{The SHA256 hash of this file}</Hash>
                </File>
            </FileList>
        </CabExtensionDeployment>
	</Deployments>
</CustomExtensionManifest>

範例manifest.xml檔案：

<CustomExtensionManifest ExtensionID="808b9ce3-e574-49be-82be-64ed35d800c5" Name="Nice Console Node and Console Action Extension" Description="Very Useful Extension" Version="1.1" Author="Me">
	<Deployments>
		<NodeExtensionDeployment ParentNode="d61498cb-7b3f-4748-ae3e-026674fb0cbd">
			<FileList>
				<File Name="Test.xml">
					<Hash Algorithm="sha256">543F2947AEA734B6833F275091AC6A159C0FCD341373D6E53062E37281B602B3</Hash>
				</File>
			</FileList>
		</NodeExtensionDeployment>
      <ActionExtensionDeployment ParentNode="172d85e7-bb7a-4479-a6a2-768f175b75cb">
        <FileList>
          <File Name="Test2.xml">
            <Hash Algorithm="sha256">C60FB69B86BF9B2E924FF272292CA2C97864D636B8190C95DC926049651A002E</Hash>
          </File>
        </FileList>
      </ActionExtensionDeployment>
	</Deployments>
</CustomExtensionManifest>

向網站註冊擴充功能以進行測試

當您將延伸模組建置並封裝到 authenticode 簽署的 .cab 檔案時，可以在Configuration Manager實驗室環境中進行測試。您將透過系統管理服務張貼來執行此動作。將擴充功能插入月臺後，您可以核准它，並從 主控台擴充 功能節點本機安裝它。

重要事項

針對本機測試，您可以在使用 2107 版或更新版本時匯入未簽署的主控台擴充功能。如需詳細資訊和其他匯入方法，請參閱匯入主控台擴充功能。

編輯 $adminServiceProvider 和 $cabFilePath 之後，請執行下列 PowerShell 腳本：

$adminServiceProvider - 安裝系統管理服務的最上層 SMSProvider 伺服器
$cabFilePath - 延伸模組的 authenticode 簽署 .cab 檔案路徑

$adminServiceProvider = "SMSProviderServer.contoso.com"
$cabFilePath = "C:\Testing\MyExtension.cab"
$adminServiceURL = "https://$adminServiceProvider/AdminService/v1/ConsoleExtensionMetadata/AdminService.UploadExtension"
$cabFileName = (Get-Item -Path $cabFilePath).Name
$Data = Get-Content $cabFilePath
$Bytes = [System.IO.File]::ReadAllBytes($cabFilePath)
$base64Content = [Convert]::ToBase64String($Bytes)

$Headers = @{
    "Content-Type" = "Application/json"
}

$Body = @{
            CabFile = @{
                FileName = $cabFileName
                FileContent = $base64Content
            }
        } | ConvertTo-Json

$result = Invoke-WebRequest -Method Post -Uri $adminServiceURL -Body $Body -Headers $Headers -UseDefaultCredentials

if ($result.StatusCode -eq 200) {Write-Host "$cabFileName was published successfully."}
else {Write-Host "$cabFileName publish failed. Review AdminService.log for more information."}

在Configuration Manager主控台中，移至 [系統管理>概觀>更新和維護>主控台擴充功能] 。
選取您的延伸模組，然後選擇 [ 核准安裝]。
若要在目前的主控台上安裝擴充功能，請選取 [本機擴充功能] 底下的 [安裝]。
使用相同的擴充功能和相同的版本重新執行 PowerShell 腳本，將會覆寫目前現有的版本。

僅適用于 technical Preview 版本的 Configuration Manager

請確定您已加入社群中樞，而且在您的加入要求獲得核准之後，您已接受邀請。您參與擴充功能的方式與參與其他社群中樞物件的方式相同。不過，針對其他需求和其他資訊，您需要提供擴充功能。當您將主控台擴充功能提供給社群中樞時，必須簽署內容。主控台擴充功能的內容不是由Microsoft所裝載。當您參與專案時，系統會要求您提供已簽署 .cab 檔案的位置，以及擴充功能的其他資訊。參與延伸模組需要下列專案：

內容 URL：可 .cab 下載檔案的位置
內容的 SHA-256 雜湊：檔案的 .cab SHA-256 雜湊
授權 URL：擴充功能的授權 URL，例如 https://mit-license.org/
隱私權聲明 URL：隱私權聲明的 URL

重要事項

如果您透過系統管理服務在本機將擴充功能匯入主控台，如果您嘗試從社群中樞下載相同的擴充功能，下載將會失敗。若要測試從社群中樞下載延伸模組，請刪除匯入的延伸模組，然後從社群中樞下載。

分享方式：

透過社群中樞註冊主控台擴充功能

版本資訊

先決條件

建立延伸模組

建立有效的承載 cab 檔案

向網站註冊擴充功能以進行測試

後續步驟

意見反映

意見反映

更多資源

分享方式：

透過社群中樞註冊主控台擴充功能

版本資訊

先決條件

建立延伸模組

建立有效的承載 cab 檔案

向網站註冊擴充功能以進行測試

在社群中樞上共用您的擴充功能

後續步驟

意見反映

意見反映

更多資源