Aggiunta di voci ai collegamenti CONFIGURAZIONE, COMPONENTI AGGIUNTIVI, STATO RAPIDO e GUIDAAdd Entries to SETUP, ADD-INS, QUICK STATUS, and HELP Links

Si applica a: 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

È possibile aggiungere delle attività agli elenchi CONFIGURA, COMPONENTI AGGIUNTIVI, RIEPILOGO SULLO STATO e aggiungere collegamenti alla sezione Collegamenti alla comunità nella pagina iniziale del dashboard.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. Le attività e i collegamenti vengono aggiunti a questi elenchi e a questa sezione collocando un file XML denominato OEMHomePageContent.home o un file delle risorse incorporato denominato OEMHomePageContent.dll in %Programmi%\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. Il file delle risorse predefinito può essere utilizzato per localizzare il testo nelle attività e nei collegamenti aggiunti.The embedded resource file can be used to localize the text in the tasks and links that you add. Il file .home contiene le definizioni XML delle attività e dei collegamenti.The .home file contains the XML definitions of the tasks and links.

Per aggiungere attività agli elenchi CONFIGURA, COMPONENTI AGGIUNTIVI, RIEPILOGO SULLO STATO e collegamenti all'attività GUIDA , definire le attività e i collegamenti utilizzando un file XML oppure, in alternativa, creare un file delle risorse incorporato e installarlo sul server.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. Se il file XML viene installato sul server senza un file delle risorse, deve chiamarsi OEMHomePageContent.home.If the XML file is being installed on the server without a resource file, it must be named OEMHomePageContent.home. Se viene utilizzato un assembly per installare sia il file XML che il file delle risorse, l'assembly deve essere chiamato OEMHomePageContent.dll e deve essere firmato con 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.

Per creare il file .home, utilizzare un editor di testo quale Blocco note, mentre se viene creato anche un file di risorse incorporato, utilizzare Visual Studio 2010 o una versione successiva per definire i file.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. Nella procedura seguente è descritto l'uso di Visual Studio 2010 o una versione successiva per la creazione di file.The following procedure shows how to use Visual Studio 2010 or higher to create the files.

  1. Accedere a Visual Studio 2010 o una versione successiva come amministratore facendo clic con il pulsante destro del mouse sul programma nel menu Start, quindi selezionando Esegui come amministratore.Open Visual Studio 2010 or higher as an administrator by right-clicking the program in the Start menu and selecting Run as administrator.

  2. Fare clic su File, quindi su Nuovoe infine su Progetto.Click File, click New, and then click Project.

  3. Nel riquadro Modelli , fare clic su Libreria di classi, digitare OEMHomePageContent nella casella Nome , quindi fare clic su OK.In the Templates pane, click Class Library, type OEMHomePageContent in the Name box, and then click OK.

  4. Eliminare il file Class1.cs.Delete the Class1.cs file.

  5. Con il pulsante destro del mouse, fare clic sul nuovo progetto, selezionare Aggiungi, quindi Nuovo elemento.Right-click the new project, click Add, and then click New Item.

  6. Nel riquadro Modelli fare clic su File XML, digitare OEMHomePageContent.home nella casella Nome e quindi fare clic su Aggiungi.In the Templates pane, click XML File, type OEMHomePageContent.home in the Name box, and then click Add.

    Nota

    Se il file XML viene installato senza un file delle risorse, deve chiamarsi OEMHomePageContent.home.If the XML file is being installed without a resource file, it must be named OEMHomePageContent.home. Se è incluso in un assembly, è possibile assegnargli qualsiasi nome con estensione .home.If it is included in an assembly, it can be given any name as long as it has a .home extension.

  7. Aggiungere il seguente codice XML al file OEMHomePageContent.home:Add the following XML code to the OEMHomePageContent.home file:

    
    <Tasks version=?2.0? xmlns=?https://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>  
    

    Dove:Where:

    AttributoAttribute DescrizioneDescription
    Nome (attività)Name (Task) Il nome visualizzato per l'attività nell'elenco.The name that is displayed for the task in the list. Se si crea un file di risorse incorporato, il valore di questo attributo corrisponde alla risorsa di tipo stringa.If you create an embedded resource file, the value of this attribute is the string resource.
    descrizione (attività)description (Task) La descrizione dell'attività.The description of the task. Se si crea un file di risorse incorporato, il valore di questo attributo corrisponde alla risorsa di tipo stringa.If you create an embedded resource file, the value of this attribute is the string resource.
    id (attività)id (Task) L'identificatore dell'attività.The identifier of the task. Questo identificatore deve essere un GUID.This identifier must be a GUID. È necessario creare un nuovo GUID per le attività exe , mentre per le attività globali occorre utilizzare il GUID creato al momento della definizione dell'attività per il relativo riquadro della sottoscheda. Per altre informazioni sulla creazione di un GUID, vedere Crea GUID (guidgen.exe).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. For more information about creating a GUID, see Create Guid (guidgen.exe).
    imageimage Questo campo verrà ignorato.This field will be ignored.
    Nome (azione)Name (Action) Visualizza il nome dell'attività.Displays the name of the task.
    Tipo (azione)Type (Action) Descrive il tipo di attività.Describes the type of task. L'attività può essere: globale, exe o un URL.The task can one of the following:- global task, exe, or a url task. Un'attività globale corrisponde alla medesima attività globale creata durante la definizione delle attività per il relativo riquadro nella sottoscheda. Per altre informazioni sulla creazione di un'attività globale che può essere utilizzata in sia nel riquadro attività della sottoscheda e gli elenchi attività preliminari o attività comuni della home page, vedere œCreating le classi di supporto? in come: Creare una sottoscheda? del Windows Server Solutions SDK.A global task is the same global task that you created when defining the tasks for the task pane in the sub-tab. 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. Un'attività exe può essere utilizzata per eseguire le applicazioni dagli elenchi Attività preliminari o Attività comuni.An exe task can be used to run applications from the Getting Started Tasks or Common Tasks lists.
    exelocationexelocation Il percorso dell'applicazione associata all'attività.The path to the application that is associated with the task. Questo attributo viene utilizzato solo attività di tipo exe.This attribute is only used for exe tasks.
    replaceidreplaceid L'identificatore dell'attività che viene sostituito con questa attività.The identifier of the task that is replaced with this task.
    assemblyassembly Il nome dell'assembly che fornisce la classe per l'implementazione della query per ottenere un riepilogo delle informazioni sullo stato.The AssemblyName of the assembly which provides the class to implement quick status query. L'assembly deve trovarsi in Program Files \ windows Server\Bin.\.The assembly needs to be located in Program files\ windows server\bin\.
    classeclass Il nome della classe implementa la query per ottenere un riepilogo delle informazioni sullo stato.The name of the class implements quick status query. La classe deve implementare l'interfaccia ITaskStatusQuery .The class needs to implement ITaskStatusQuery interface.
    Titolo (collegamento)Title (link) Il testo visualizzato per il collegamento.The text that is displayed for the link. Se si crea un file di risorse incorporato, il valore di questo attributo corrisponde alla risorsa di tipo stringa.If you create an embedded resource file, the value of this attribute is the string resource.
    Descrizione (collegamento)Description (link) La descrizione della destinazione del collegamento.The description of the link destination. Se si crea un file di risorse incorporato, il valore di questo attributo corrisponde alla risorsa di tipo stringa.If you create an embedded resource file, the value of this attribute is the string resource.
    ShellExecPathShellExecPath Il percorso dell'applicazione o dell'URL.The path to the application or the URL.

    Nota: Le variabili di ambiente sono supportate nell'attributo ShellExecPath.Note: Environment variables are supported in the ShellExecPath attribute.

    L'esempio di codice seguente mostra in quale modo definire un collegamento a un'applicazione: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>  
    

    L'esempio di codice seguente mostra in quale modo definire un collegamento a una pagina 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. Modificare i valori di attributo per rappresentare l'attività o il collegamento.Change the attribute values to represent your task or link.

  9. In Esplora soluzioni, fare clic con il pulsante destro del mouse su OEMHomePageContent.homee quindi selezionare Proprietà.In Solution Explorer, right-click OEMHomePageContent.home, and then click Properties. Nel riquadro Proprietà, in Azione di compilazione, selezionare Risorsa incorporata.In the Properties pane, under Build Action, select Embedded Resource.

  10. Salvare il file OEMHomePageContent.home.Save the OEMHomePageContent.home file.

    Per istruzioni su come implementare una query per ottenere un riepilogo delle informazioni sullo stato, vedere la documentazione e gli esempi Windows Server Solutions SDK.For how to implement a quick status query, please refer to documents and samples in the Windows Server Solutions SDK.

Modifica dello stato di un'attività CONFIGURA/COMPONENTI AGGIUNTIVIChange the status of a SETUP/ADD-INS task

Le attività incluse negli elenchi CONFIGURA e COMPONENTI AGGIUNTIVI possono essere registrate con lo stato di completate (configurate per i componenti aggiuntivi) e non completate (non configurate per i componenti aggiuntivi).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).

Quando si definisce l'applicazione associata alla nuova attività, è possibile utilizzare il metodo SetTaskStatus dello spazio dei nomi Microsoft.WindowsServerSolutions.Administration.ObjectModel.TaskStatusHelper (incluso, ma non documentato in Windows Server Solutions SDK) per modificare lo stato dell'attività.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. Ad esempio, è possibile cambiare il segno di spunta da grigio a verde richiamando il metodo SetTaskStatus con il valore di enumerazione TaskStatus.Complete (SetTaskStatus(id, TaskStatus.Complete), dove id è l'identificatore dell'attività).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). I valori di enumerazione che è possibile utilizzare sono TaskStatus.Complete, TaskStatus.Incomplete o TaskStatus.Hidden.The enumeration values that can be used are TaskStatus.Complete, TaskStatus.Incomplete, or TaskStatus.Hidden.

Sostituzione delle attivitàReplace tasks

È possibile sostituire le attività predefinite presenti negli elenchi Azioni preliminari o Azioni comuni aggiungendo il GUID dell'attività all'attributo sostituzioneid nella definizione delle attività.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. Nella tabella seguente sono elencate le attività e gli identificatori corrispondenti che è possibile sostituire nel dashboard:The following table lists the tasks and the corresponding identifiers that can be replaced in the Dashboard:

Nome attivitàTask name IdentificatoreIdentifier
Ottenere aggiornamenti per altri prodotti MicrosoftGet updates for other Microsoft products 8412D35A-13EE-4112-AE0B-F7DBC83EA83D8412D35A-13EE-4112-AE0B-F7DBC83EA83D
Impostazione del backup del serverSet up Server Backup F68B3F3F-19DE-499D-9ACB-4BB41B8FF420F68B3F3F-19DE-499D-9ACB-4BB41B8FF420
Impostazione di Accesso remoto via InternetSet up Anywhere Access 8991302D-676A-4A7C-B244-D1E08AE0EFEA8991302D-676A-4A7C-B244-D1E08AE0EFEA
Impostazione della notifica degli avvisiSetup email alert notification DE6F2B36-F19C-4FAF-998B-9772300E3530DE6F2B36-F19C-4FAF-998B-9772300E3530
Aggiunta di un account utenteAdd a user accounts 6D5B5D5F-2EC7-4B1F-9580-4DB084B278B16D5B5D5F-2EC7-4B1F-9580-4DB084B278B1
Aggiunta di cartelle al serverAdd server folders 03F1F438-D94E-439B-A9F7-0C817C37D62503F1F438-D94E-439B-A9F7-0C817C37D625
Accesso remoto via Internet - Riepilogo sullo statoAnywhere Access - Quick Status 6093B462-1F04-4212-8804-9BC823070FAD6093B462-1F04-4212-8804-9BC823070FAD
Backup server - Riepilogo sullo statoServer Backup - Quick Status 156947D8-21DC-45FE-A9A8-2F80AE304191156947D8-21DC-45FE-A9A8-2F80AE304191
Cartelle del server - Riepilogo sullo statoServer Folders - Quick Status C657E8AB-AC1F-4AA1-8E80-5AF6BB27C314C657E8AB-AC1F-4AA1-8E80-5AF6BB27C314
Account utente attivi - Riepilogo sullo statoActive user accounts - Quick Status 68BCB125-CE8F-467F-B65B-56AD45A614B568BCB125-CE8F-467F-B65B-56AD45A614B5
Notifica degli avvisi di posta elettronica - Riepilogo sullo statoEmail alert notification - Quick Status 75AB06E7-A679-4D62-A5EC-65362FE4F9DB75AB06E7-A679-4D62-A5EC-65362FE4F9DB
Computer - Riepilogo sullo statoComputers - Quick Status 7966A974-D52D-4F5D-B37F-05C1B73CEEF37966A974-D52D-4F5D-B37F-05C1B73CEEF3
(Facoltativo) Creare il file di risorse(Optional) Create the resource file

Per localizzare il testo nelle attività da aggiungere a Attività preliminari, Attività comuni e Collegamenti alla comunità, è necessario creare un assembly che contenga il file .home e un file .home.resx che definisca le stringhe di testo.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.

Per creare il file di risorseTo create the resource file
  1. Con il pulsante destro del mouse, fare clic sul progetto creato per le attività, selezionare Aggiungi, quindi Nuovo elemento.Right-click the project that you created for your tasks, click Add, and then click New Item.

  2. Nel riquadro Modelli, fare clic su File di risorse, digitare OEMHomePageContent.home.resx nella casella Nome, quindi fare clic su Aggiungi.In the Templates pane, click Resources File, type OEMHomePageContent.home.resx in the Name box, and then click Add.

    Nota

    Al file di risorse è possibile assegnare un nome qualsiasi, purché abbia l'estensione .home.resx.The resource file can be given any name as long as it has a .home.resx extension.

  3. Per ogni attività o collegamento che si desidera aggiungere, occorre aggiungere anche stringhe e valori al file OEMHomePageContent.home.resx che corrispondano agli elementi Attività e Collegamento definiti nel file OEMHomePageContent.home.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. Nel seguente esempio di codice è riportato un esempio di file Tasks.xml strutturato per il file di risorse:The following code example shows an example of a Tasks.xml file that is structured for the resource file:

    
    <Tasks version=?2.0? xmlns=?https://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>  
    
    

    Nota

    Gli identificatori di attributi utilizzati per la localizzazione non possono contenere spazi.Identifiers in attributes that are used for localization cannot contain spaces.

  4. Aggiungere i nomi di risorsa MyTaskDescription, MyActionName e IconForAction al file .resx con i valori appropriati.Add the MyTask, MyTaskDescription, MyActionName, and IconForAction resource names to the .resx file with the appropriate values.

  5. Salvare il file OEMHomePageContent.home.resx, quindi generare la soluzione.Save the OEMHomePageContent.home.resx file, and then build the solution.

Firmare l'assembly con una firma AuthenticodeSign the assembly with an Authenticode signature

Per poter utilizzare l'assembly nel sistema operativo, è necessario applicarvi una firma Authenticode.You must Authenticode sign the assembly for it to be used in the operating system. Per altre informazioni sulla firma dell'assembly, vedere Firma e verifica del codice con Authenticode.For more information about signing the assembly, see Signing and Checking Code with Authenticode.

Installazione dei file delle attivitàInstall the task files

Una volta creati i file .home e .home.resx, occorre installarli sul server.After you create the .home and .home.resx files, you must install them on the server.

Per installare i file delle attivitàTo install the task files
  1. Accertarsi che la soluzione venga generata senza errori.Ensure that your solution builds without errors.

  2. Se non è stato creato un file di risorse incorporato, copiare il file OEMHomePageContent.home in %Programmi%\Windows Server\Bin\Addins\Home nel server.If you did not create an embedded resource file, copy the OEMHomePageContent.home file to %ProgramFiles%\Windows Server\Bin\Addins\Home on the server. Se è stato creato un file di risorse incorporato, copiare il file OEMHomePageContent.dll in %Programmi%\Windows Server\Bin\Addins\Home nel server.If you created an embedded resource file, copy the OEMHomePageContent.dll file to %ProgramFiles%\Windows Server\Bin\Addins\Home on the server.

Vedere ancheSee Also

Creazione e personalizzazione dell'immagine Creating and Customizing the Image
Personalizzazioni aggiuntive Additional Customizations
Preparazione dell'immagine per la distribuzione Preparing the Image for Deployment
Test di Analisi utilizzo softwareTesting the Customer Experience