Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Autorzy rozszerzeń konsoli mogą współtworzyć napisane przez siebie rozszerzenia w centrum społeczności. Użytkownicy centrum społeczności mogą pobrać rozszerzenia i zarządzać ich instalacją w hierarchii programu Configuration Manager. Współtworzenie rozszerzeń za pośrednictwem Centrum społeczności zastępuje poprzedni proces wdrażania.
Wersja
Aby pobrać rozszerzenia konsoli z centrum społeczności, potrzebujesz:
- Wersja Technical Preview programu Configuration Manager
- Configuration Manager w wersji 2103 lub nowszej
Możesz przetestować podpisane rozszerzenia, importując je lokalnie z następującymi wersjami:
- Wersja Technical Preview programu Configuration Manager
- Configuration Manager w wersji 2103 lub nowszej
Niepodpisane rozszerzenie można zaimportować lokalnie. Niepodpisane rozszerzenia są przeznaczone tylko do lokalnego importu i testowania. Niepodpisanych rozszerzeń nie można przesłać do centrum społeczności. Importowanie niepodpisanego rozszerzenia wymaga użycia jednej z następujących wersji:
- Technical preview w wersji 2105.2 lub nowszej.
- Configuration Manager w wersji 2107 lub nowszej
Począwszy od wersji 2111, za pomocą kreatora importowania rozszerzeń konsoli importowania można importować zarówno podpisane, jak i niepodpisane rozszerzenia.
Wymagania wstępne
Aby zarejestrować rozszerzenie konsoli w centrum społeczności dla administratorów programu Configuration Manager do pobrania, musisz spełnić następujące wymagania wstępne:
Spełniać wszystkie wymagania wstępne dotyczące współtworzenia centrum społeczności
Pełny administrator programu Configuration Manager ze wszystkimi prawami zakresu.
Prawidłowy ładunek w pliku podpisanym
.cabprzez authenticode, gdy wszystko będzie gotowe do opublikowania. Plik.cabmusi zawierać następujące elementy:- Plik manifestu o nazwie
manifest.xml - Autor i wersja rozszerzenia muszą być wymienione w
manifest.xml - Wszystkie pliki odpowiednie dla rozszerzenia muszą znajdować się w
.cabpliku- Każdy plik musi być wymieniony w manifeście i mieć poprawną nazwę oraz skrót SHA256
- Plik manifestu o nazwie
Tworzenie rozszerzenia
Tworzenie rozszerzenia dla centrum społeczności nie różni się zbytnio od tego, jak robiono to wcześniej. Nie ma już jednak potrzeby instalowania plików w odpowiednim %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions folderze. Jest to część funkcji nowego manifest.xml pliku. Nadal możesz utworzyć następujące elementy:
- Czynności
- Formularze
- Zajęcia z zarządzania
- Węzły
- Wyświetlenia
- Zintegruj własnych kreatorów niestandardowych z konsolą programu Configuration Manager przy użyciu wybranej struktury kreatora
- Nie można tworzyć kreatorów przy użyciu istniejącej struktury konsoli programu Configuration Manager.
- Nie można modyfikować ani usuwać kroków z istniejących kreatorów programu Configuration Manager.
Porada
Z repozytorium GitHub w centrum społeczności, możesz pobrać plik cab przykładowego rozszerzenia.
Tworzenie prawidłowego pliku cab ładunku
Po utworzeniu plików dla rozszerzenia utworzysz manifest.xml plik, a następnie spakujesz je wszystkie razem w plik podpisany .cab przez authenticode.
- Prawidłowy ładunek w pliku podpisanym
.cabprzez authenticode. Plik.cabmusi zawierać następujące elementy:- Plik manifestu o nazwie
manifest.xml - Autor i wersja rozszerzenia muszą być wymienione w
manifest.xml - Wszystkie pliki odpowiednie dla rozszerzenia muszą znajdować się w
.cabpliku- Każdy plik musi być wymieniony w manifeście i mieć poprawną nazwę oraz skrót SHA256
- Plik manifestu o nazwie
Manifest.xml format:
<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>
Przykładowy plik 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>
Rejestrowanie rozszerzenia w witrynie na potrzeby testowania
Gdy masz rozszerzenie wbudowane i spakowane do pliku podpisanego .cab przez authenticode, możesz je przetestować w środowisku laboratorium programu Configuration Manager. Zrobisz to, publikując go za pośrednictwem usługi administracyjnej. Po wstawieniu rozszerzenia do lokacji możesz je zatwierdzić i zainstalować lokalnie z węzła Rozszerzenia konsoli .
Ważna
Na potrzeby testowania lokalnego możesz zaimportować niepodpisane rozszerzenia konsoli, gdy używasz wersji 2107 lub nowszej. Aby uzyskać więcej informacji i dodatkowe metody importowania, zobacz Importowanie rozszerzeń konsoli.
Uruchom następujący skrypt programu PowerShell po edytowaniu pliku
$adminServiceProvideri$cabFilePath:-
$adminServiceProvider- Serwer najwyższego poziomu SMSProvider, na którym zainstalowana jest usługa administracyjna -
$cabFilePath- Ścieżka do pliku podpisanego.cabprzez authenticode rozszerzenia
$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."}-
W konsoli programu Configuration Manager przejdź do pozycjiOmówienie>administracji>: aktualizacje i rozszerzenia konsoli obsługi>.
Wybierz rozszerzenie, a następnie wybierz pozycję Zatwierdź instalację.
Aby zainstalować rozszerzenie na bieżącej konsoli, wybierz pozycję Zainstaluj w obszarze Rozszerzenie lokalne.
Ponowne uruchomienie skryptu programu PowerShell z tym samym rozszerzeniem i tą samą wersją spowoduje zastąpienie bieżącego istniejącego.
Udostępnianie rozszerzenia w centrum społeczności
Dotyczy tylko wersji Technical Preview programu Configuration Manager
Upewnij się, że dołączono do centrum społeczności i że zaakceptowano zaproszenie po zatwierdzeniu Twojej prośby o dołączenie. Rozszerzenia współtworzy się w taki sam sposób, jak w przypadku innych obiektów centrum społeczności. Jednak w celu spełnienia dodatkowych wymagań i dodatkowych informacji musisz podać przedłużenie terminu. Gdy dodajesz rozszerzenie konsoli do centrum społeczności, zawartość musi być podpisana. Zawartość rozszerzenia konsoli nie jest hostowana przez firmę Microsoft. Podczas dodawania elementu zostanie wyświetlony monit o podanie lokalizacji podpisanego .cab pliku oraz innych informacji dotyczących rozszerzenia. Następujące elementy są wymagane do współtworzenia rozszerzeń:
-
Adres URL zawartości: lokalizacja pliku do
.cabpobrania -
Skrót SHA-256 zawartości: skrót
.cabSHA-256 pliku - Adres URL licencji: adres URL licencji rozszerzenia, taki jak https://mit-license.org/
- Adres URL oświadczenia o ochronie prywatności: adres URL oświadczenia o ochronie prywatności
Ważna
Jeśli zaimportujesz rozszerzenie lokalnie do konsoli, publikując je za pośrednictwem usługi administracyjnej, pobieranie nie powiedzie się, jeśli spróbujesz pobrać to samo rozszerzenie z Centrum społeczności. Aby przetestować pobieranie rozszerzenia z Centrum społeczności, usuń zaimportowane rozszerzenie, a następnie pobierz je z Centrum społeczności.