Dodaj wpisy skonfigurować, dodatki, KRÓTKIEGO stanu i łączy PomocyAdd Entries to SETUP, ADD-INS, QUICK STATUS, and HELP Links

Dotyczy: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 EssentialsApplies To: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials, Windows Server 2012 Essentials

Można dodawać zadania do instalacji, dodatki, KRÓTKIEGO stanu zadanie listy, możesz dodać łączy do sekcji łącza społeczności strony głównej pulpitu nawigacyjnego.You can add tasks to the SETUP, ADD-INS, QUICK STATUS task lists, and you can add links to the Community Links section in the home page of the Dashboard. Zadania i łącza są dodawane do tych list i sekcji, umieszczając plik XML o nazwie OEMHomePageContent.home plik lub plik osadzony zasób o nazwie OEMHomePageContent.dll w %ProgramFiles%\Windows Server\Bin\Addins\Home.Tasks and links are added to these lists and section by placing an XML file named OEMHomePageContent.home file or an embedded resource file named OEMHomePageContent.dll in %ProgramFiles%\Windows Server\Bin\Addins\Home. Plik osadzony zasób może służyć do zlokalizowania tekst zadania i łącza, który dodajesz.The embedded resource file can be used to localize the text in the tasks and links that you add. Plik .home zawiera definicje XML zadania i łącza.The .home file contains the XML definitions of the tasks and links.

Można dodawać zadania do instalacji, dodatki, KRÓTKIEGO stanu list i łącza do zadania Pomoc zadanie, definiując zadania i łącza za pomocą języka XML, opcjonalnie Tworzenie pliku osadzony zasób i instalowania go na serwerze.You can add tasks to the SETUP, ADD-INS, QUICK STATUS task lists, and links to the HELP task by defining the tasks and links using XML, optionally creating the embedded resource file, and installing the file on the server. Jeśli plik XML jest instalowany na serwerze sieci Web bez pliku zasobów, musi mieć nazwę OEMHomePageContent.home.If the XML file is being installed on the server without a resource file, it must be named OEMHomePageContent.home. Jeśli zespół jest używany do zainstalowania pliku XML i pliku zasobów, musi mieć nazwę OEMHomePageContent.dll i musi być podpisany Authenticode.If an assembly is being used to install both an XML file and a resource file, it must be named OEMHomePageContent.dll and it must be Authenticode signed.

Można użyć edytora tekstu, takiego jak Notatnik, aby utworzyć plik .home lub są również tworzenia pliku osadzony zasób służy programu Visual Studio 2010 lub nowszego do definiowania pliki.You can use a text editor such as Notepad to create the .home file, or if you are also creating an embedded resource file you can use Visual Studio 2010 or higher to define the files. Poniższa procedura pokazuje, jak używać programu Visual Studio 2010 lub nowszego do tworzenia plików.The following procedure shows how to use Visual Studio 2010 or higher to create the files.

  1. Otwórz program Visual Studio 2010 lub nowszy jako administrator, klikając prawym przyciskiem myszy program w Start menu i wybierając Uruchom jako administrator.Open Visual Studio 2010 or higher as an administrator by right-clicking the program in the Start menu and selecting Run as administrator.

  2. Kliknij przycisk pliku, kliknij przycisk nowy, a następnie kliknij przycisk projektu.Click File, click New, and then click Project.

  3. W szablony okienku kliknij Biblioteka klas, typ OEMHomePageContent w nazwa, a następnie kliknij przycisk OK.In the Templates pane, click Class Library, type OEMHomePageContent in the Name box, and then click OK.

  4. Usuń plik Class1.cs.Delete the Class1.cs file.

  5. Kliknij prawym przyciskiem myszy nowy projekt, kliknij przycisk Dodaj, a następnie kliknij przycisk nowy element.Right-click the new project, click Add, and then click New Item.

  6. W szablony okienku kliknij pliku XML, typ OEMHomePageContent.home w nazwa, a następnie kliknij przycisk Dodaj.In the Templates pane, click XML File, type OEMHomePageContent.home in the Name box, and then click Add.

    Uwaga

    Jeśli plik XML jest instalowany bez plik zasobów, musi mieć nazwę OEMHomePageContent.home.If the XML file is being installed without a resource file, it must be named OEMHomePageContent.home. Jeśli jest włączona w zespole, może uzyskać dowolną nazwę tak długo, jak ma rozszerzenie .home.If it is included in an assembly, it can be given any name as long as it has a .home extension.

  7. Dodaj następujący kod XML w pliku OEMHomePageContent.home:Add the following XML code to the OEMHomePageContent.home file:

    
    <Tasks version=?2.0? xmlns=?http://schemas.microsoft.com/WindowsServerSolutions/2010/01/Dashboard>  
       <SetupMyServerTasks>  
          <Task name="MyTask"  
             description="MyTaskDescription"  
             id="GUID">  
                  <Action   
                  name=?MyAction1Name?   
                  image=?IconForAction1?  
                  type=?TaskType?  
                  exelocation=?ActionExeLocation? />  
                  <Action   
                  name=?MyAction2Name?   
                  image=?IconForAction2?  
                  type=?TaskType?  
                  exelocation=?ActionExeLocation? />  
                   ¦  
           </Task>  
                   ¦  
        </SetupMyServerTasks>  
    <MailServiceTasks>  
         <!-- Same schema as in œSetupMyServerTasks? but the tasks are shown in œConnect to Email Service? category. -->  
    </MailServiceTasks>  
    <LineOfBusinessTasks>  
         <!-- Same schema as in œSetupMyServerTasks? but the tasks are shown in œAdd-ins? category. -->  
    
    <GetQuickStatusTasks>  
          <Task name="MyQuickStatusTask1"  
             description="MyQuickStatusTask1Desc   "  
             id="GUID"  
             assembly="AssemblyName of quick status query implementation"  
             class="ClassName of quick status query implementation"           
             replaceid="GUID"/>  
               <!--  Same schema as Actions in œSetupMyServerTasks? -->   
             </Task>  
    </GetQuickStatusTasks>  
       <Links>  
          <Link  
             ID=?GUID?  
             Title="Displayed text of the link"  
             Description="A very short description"  
             ShellExecPath="Path to the application or URL"/>  
       </Links>  
    </Tasks>  
    

    W przypadku gdy:Where:

    AtrybutAttribute OpisDescription
    Nazwa (zadania)Name (Task) Nazwa, która jest wyświetlana na liście zadania.The name that is displayed for the task in the list. Jeśli tworzysz plik osadzony zasób, wartość tego atrybutu jest zasobu ciągu.If you create an embedded resource file, the value of this attribute is the string resource.
    Opis (zadania)description (Task) Opis zadania.The description of the task. Jeśli tworzysz plik osadzony zasób, wartość tego atrybutu jest zasobu ciągu.If you create an embedded resource file, the value of this attribute is the string resource.
    Identyfikator (zadania)id (Task) Identyfikator zadania.The identifier of the task. Ten identyfikator musi być identyfikatorem GUID.This identifier must be a GUID. Utwórz nowy identyfikator GUID dla exe zadania, jednak w przypadku globalnego zadanie, można użyć identyfikator GUID, który został utworzony po zdefiniowaniu zadania w okienku zadań podrzędnych karty.You create a new GUID for an exe task, but for a global task, you use the GUID that you created when you defined the task for the task pane of the sub-tab. Aby uzyskać więcej informacji na temat tworzenia identyfikatora GUID, zobacz (guidgen.exe) utworzyć identyfikator Guid.For more information about creating a GUID, see Create Guid (guidgen.exe).
    Obrazimage W tym polu, zostaną zignorowane.This field will be ignored.
    Nazwa (Akcja)Name (Action) Wyświetla nazwę zadania.Displays the name of the task.
    Typ (Akcja)Type (Action) W tym artykule opisano typ zadania.Describes the type of task. Zadanie można jedną z następujących czynności:- globalnego zadanie, exe, lub zadanie adresu url.The task can one of the following:- global task, exe, or a url task. A globalnego zadanie jest tego samego zadania globalne, które utworzono podczas definiowania zadań w okienku zadań na karcie podrzędnych.A global task is the same global task that you created when defining the tasks for the task pane in the sub-tab. Aby uzyskać więcej informacji o tworzeniu globalnego zadanie, które mogą być używane w obu okienka zadań podrzędnych karty i listy wprowadzenie zadania lub typowych zadań strony głównej Zobacz œCreating klasy pomocy technicznej? w œHow do: tworzenia podrzędnych karty? z systemu Windows Server — rozwiązania dotyczące zestawu SDK.For more information about creating a global task that can be used in both the tasks pane of the sub-tab and the Getting Started Tasks or Common Tasks lists of the home page, see œCreating the support classes? in œHow to: Create a Sub-Tab? of the Windows Server Solutions SDK. Exe zadanie może służyć do uruchamiania aplikacji z zadaniami wprowadzenie uruchomiona lub wyświetla listę typowych zadań.An exe task can be used to run applications from the Getting Started Tasks or Common Tasks lists.
    exelocationexelocation Ścieżka do aplikacji, który jest skojarzony z zadaniem.The path to the application that is associated with the task. Ten atrybut jest używany tylko do exe zadania.This attribute is only used for exe tasks.
    replaceidreplaceid Identyfikator zadania, który jest zastępowany tego zadania.The identifier of the task that is replaced with this task.
    zestawassembly AssemblyName zestawu, którego dostarcza klasę do zaimplementowania krótkiego stanu kwerendy.The AssemblyName of the assembly which provides the class to implement quick status query. Zestaw musi znajdować się w programie files\ windows server\bin\.The assembly needs to be located in Program files\ windows server\bin\.
    klasyclass Nazwa klasy implementuje krótkiego stanu kwerendy.The name of the class implements quick status query. Klasa należy zaimplementować ITaskStatusQuery interfejsu.The class needs to implement ITaskStatusQuery interface.
    Tytuł (link)Title (link) Tekst, który jest wyświetlany dla łącza.The text that is displayed for the link. Jeśli tworzysz plik osadzony zasób, wartość tego atrybutu jest zasobu ciągu.If you create an embedded resource file, the value of this attribute is the string resource.
    Opis (link)Description (link) Opis miejsce docelowe łącza.The description of the link destination. Jeśli tworzysz plik osadzony zasób, wartość tego atrybutu jest zasobu ciągu.If you create an embedded resource file, the value of this attribute is the string resource.
    ShellExecPathShellExecPath Ścieżka do aplikacji lub adresu URL.The path to the application or the URL.

    Uwaga: zmienne środowiskowe są obsługiwane w atrybucie ShellExecPath.Note: Environment variables are supported in the ShellExecPath attribute.

    W poniższym przykładzie przedstawiono sposób definiowania łącza do aplikacji:The following code example shows how to define a link to an application:

    <Links>  
       <Link Title="Calc" Description="Launches Calc" ShellExecPath="%windir%\system32\calc.exe" />  
    </Links>  
    

    W poniższym przykładzie przedstawiono sposób definiowania łącze do strony sieci Web:The following code example shows how to define a link to a Web page:

    <Links>  
       <Link Title="Browser" Description="Open browser" ShellExecPath="http://www.adventureworks.com/" />  
    </Links>  
    
  8. Zmiany wartości atrybutów do reprezentowania swoje zadania lub łącza.Change the attribute values to represent your task or link.

  9. W Eksploratorze rozwiązań, kliknij prawym przyciskiem myszy OEMHomePageContent.home, a następnie kliknij przycisk właściwości.In Solution Explorer, right-click OEMHomePageContent.home, and then click Properties. W właściwości okienku w obszarze tworzenie akcji, wybierz opcję osadzony zasób.In the Properties pane, under Build Action, select Embedded Resource.

  10. Zapisz plik OEMHomePageContent.home.Save the OEMHomePageContent.home file.

    Jak zaimplementować kwerendy krótkiego stanu, zapoznaj się z dokumentami i przykłady w SDK systemu Windows Server rozwiązania.For how to implement a quick status query, please refer to documents and samples in the Windows Server Solutions SDK.

Zmiana stanu zadania konfiguracji/dodatkiChange the status of a SETUP/ADD-INS task

Zadania, które są wymienione w instalacji i dodatki można przełączać na stany ukończone (skonfigurowane do Add-ins) i nie zakończone (nie zostanie skonfigurowane dla Add-ins).The tasks that are listed in SETUP and ADD-INS can be toggled in states of completed (configured for Add-ins) and not completed (not configured for Add-ins).

Podczas definiowania aplikacji, który jest skojarzony z nowego zadania, można użyć metody SetTaskStatus przestrzeni nazw Microsoft.WindowsServerSolutions.Administration.ObjectModel.TaskStatusHelper (włączone, ale nie są udokumentowane w zestawie SDK systemu Windows Server rozwiązań) Aby zmienić stan zadania.When you define the application that is associated with your new task, you can use the SetTaskStatus method of the Microsoft.WindowsServerSolutions.Administration.ObjectModel.TaskStatusHelper namespace (included, but not documented in the Windows Server Solutions SDK) to change the status of the task. Na przykład można można zmienić znacznik wyboru z szary zielony przez wywołanie metody SetTaskStatus z wartością wyliczenia TaskStatus.Complete (SetTaskStatus (identyfikator, TaskStatus.Complete), gdzie identyfikator jest identyfikator zadania).For example, you could change the check mark from grey to green by calling the SetTaskStatus method with the TaskStatus.Complete enumeration value (SetTaskStatus(id, TaskStatus.Complete), where id is the identifier of the task). Wartości wyliczenia, które mogą być używane są TaskStatus.Complete, TaskStatus.Incomplete lub TaskStatus.Hidden.The enumeration values that can be used are TaskStatus.Complete, TaskStatus.Incomplete, or TaskStatus.Hidden.

Zamień zadaniaReplace tasks

Można zastąpić zadania, które są wstępnie zdefiniowanej w zadań wprowadzenie uruchomiona lub listy typowych zadań, dodając identyfikator GUID zadania do atrybutu replaceid definicji zadania.You can replace the tasks that are pre-defined in the Getting Started Tasks or the Common Tasks lists by adding the GUID for the task to the replaceid attribute of the task definition. W poniższej tabeli wymieniono zadania i odpowiednie identyfikatory, które mogą zostać zastąpione na pulpicie nawigacyjnym:The following table lists the tasks and the corresponding identifiers that can be replaced in the Dashboard:

Nazwa zadaniaTask name IdentyfikatorIdentifier
Uzyskiwanie aktualizacji dla innych produktów firmy MicrosoftGet updates for other Microsoft products 8412D35A-13EE-4112-AE0B-F7DBC83EA83D8412D35A-13EE-4112-AE0B-F7DBC83EA83D
Konfigurowanie kopii zapasowej serweraSet up Server Backup F68B3F3F-19DE-499D-9ACB-4BB41B8FF420F68B3F3F-19DE-499D-9ACB-4BB41B8FF420
Konfigurowanie dostęp z dowolnego miejscaSet up Anywhere Access 8991302D-676A-4A7C-B244-D1E08AE0EFEA8991302D-676A-4A7C-B244-D1E08AE0EFEA
Ustawienia e-mail powiadomienie o alercieSetup email alert notification DE6F2B36-F19C-4FAF-998B-9772300E3530DE6F2B36-F19C-4FAF-998B-9772300E3530
Dodawanie kont użytkownikówAdd a user accounts 6D5B5D5F-2EC7-4B1F-9580-4DB084B278B16D5B5D5F-2EC7-4B1F-9580-4DB084B278B1
Dodawanie folderów na serwerzeAdd server folders 03F1F438-D94E-439B-A9F7-0C817C37D62503F1F438-D94E-439B-A9F7-0C817C37D625
Dostęp z dowolnego miejsca - krótkiego stanuAnywhere Access - Quick Status 6093B462-1F04-4212-8804-9BC823070FAD6093B462-1F04-4212-8804-9BC823070FAD
Kopia zapasowa serwera - krótkiego stanuServer Backup - Quick Status 156947D8-21DC-45FE-A9A8-2F80AE304191156947D8-21DC-45FE-A9A8-2F80AE304191
Foldery na serwerze - krótkiego stanuServer Folders - Quick Status C657E8AB-AC1F-4AA1-8E80-5AF6BB27C314C657E8AB-AC1F-4AA1-8E80-5AF6BB27C314
Aktywne konta użytkowników - krótkiego stanuActive user accounts - Quick Status 68BCB125-CE8F-467F-B65B-56AD45A614B568BCB125-CE8F-467F-B65B-56AD45A614B5
Wyślij wiadomość e-mail powiadomienie o alercie - krótkiego stanuEmail alert notification - Quick Status 75AB06E7-A679-4D62-A5EC-65362FE4F9DB75AB06E7-A679-4D62-A5EC-65362FE4F9DB
Komputery - krótkiego stanuComputers - Quick Status 7966A974-D52D-4F5D-B37F-05C1B73CEEF37966A974-D52D-4F5D-B37F-05C1B73CEEF3
(Opcjonalnie) Utwórz plik zasobów(Optional) Create the resource file

Jeśli chcesz lokalizować tekst w zadania, które dodajesz do pobierania zadania, typowe zadania i łącza społeczności należy utworzyć zespół, który zawiera plik .home i. home.resx pliku, który definiuje ciągi tekstowe.If you want to localize the text in the tasks that you add to Getting Started Tasks, Common Tasks, and Community Links you must create an assembly that contains the .home file and a .home.resx file that defines the text strings.

Aby utworzyć plik zasobówTo create the resource file
  1. Kliknij prawym przyciskiem myszy projektu, który został utworzony dla zadań, kliknij przycisk Dodaj, a następnie kliknij przycisk nowy element.Right-click the project that you created for your tasks, click Add, and then click New Item.

  2. W szablony okienku kliknij plik zasobów, typ OEMHomePageContent.home.resx w nazwa, a następnie kliknij przycisk Dodaj.In the Templates pane, click Resources File, type OEMHomePageContent.home.resx in the Name box, and then click Add.

    Uwaga

    Plik zasobów można otrzymać za dowolną nazwę, tak długo, jak ma. rozszerzenie home.resx.The resource file can be given any name as long as it has a .home.resx extension.

  3. Dla każdego zadania lub łącze, które można dodać do pliku OEMHomePageContent.home.resx, który odpowiada zadania i łącza elementy, które są zdefiniowane w pliku OEMHomePageContent.home należy dodać parametry i wartości.For each task or link that you add, you must add strings and values to the OEMHomePageContent.home.resx file that match the Task and Link elements that are defined in the OEMHomePageContent.home file. W poniższym przykładzie pokazano przykład Tasks.xml pliku, który ma struktury pliku zasobów:The following code example shows an example of a Tasks.xml file that is structured for the resource file:

    
    <Tasks version=?2.0? xmlns=?http://schemas.microsoft.com/WindowsServerSolutions/2010/01/Dashboard>  
       <SetupMyServerTasks>  
          <Task name="MyTask"  
             description="MyDescription"  
             id="GUID">  
             <Action  
             name="MyActionname"  
             image="IconForAction"  
             type="TaskType"  
             exelocation="ActionExeLocation" />  
          </Task>  
       </SetupMyServerTasks>  
    </Tasks>  
    
    Uwaga

    Identyfikatory atrybutów, które są używane do lokalizacji nie może zawierać spacji.Identifiers in attributes that are used for localization cannot contain spaces.

  4. Dodaj nazwy zasobów MyTask, MyTaskDescription, MyActionName i IconForAction do pliku .resx odpowiednimi wartościami.Add the MyTask, MyTaskDescription, MyActionName, and IconForAction resource names to the .resx file with the appropriate values.

  5. Zapisz plik OEMHomePageContent.home.resx, a następnie tworzyć rozwiązania.Save the OEMHomePageContent.home.resx file, and then build the solution.

Podpisz zestaw z podpisem Authenticode Sign the assembly with an Authenticode signature

Najpierw należy Authenticode znak zestawu był używany w systemie operacyjnym.You must Authenticode sign the assembly for it to be used in the operating system. Aby uzyskać więcej informacji na temat podpisywania zestawu, zobacz podpisywania i sprawdzanie kodu Authenticode.For more information about signing the assembly, see Signing and Checking Code with Authenticode.

Instalowanie plików zadańInstall the task files

Po utworzeniu .home i. home.resx plików, należy zainstalować je na serwerze.After you create the .home and .home.resx files, you must install them on the server.

Aby zainstalować pliki zadańTo install the task files
  1. Upewnij się, że rozwiązania kompilacji bez błędów.Ensure that your solution builds without errors.

  2. Jeśli nie został utworzony plik osadzony zasób, skopiuj plik OEMHomePageContent.home do %ProgramFiles%\Windows Server\Bin\Addins\Home na serwerze.If you did not create an embedded resource file, copy the OEMHomePageContent.home file to %ProgramFiles%\Windows Server\Bin\Addins\Home on the server. Jeśli został utworzony plik osadzony zasób, skopiuj plik OEMHomePageContent.dll do %ProgramFiles%\Windows Server\Bin\Addins\Home na serwerze.If you created an embedded resource file, copy the OEMHomePageContent.dll file to %ProgramFiles%\Windows Server\Bin\Addins\Home on the server.

Zobacz teżSee Also

Tworzenie i dostosowywanie obrazuCreating and Customizing the Image
Dodatkowe dostosowaniaAdditional Customizations
Przygotowywanie do wdrożenia obrazuPreparing the Image for Deployment
Testowanie środowisko klientaTesting the Customer Experience