Установка полезных данных расширения на управляемом узле

Область применения: Windows Администратор Center, Windows Администратор Center Preview

Настройка

Примечание.

Для выполнения этого руководства вам потребуется сборка 1.2.1904.02001 или более поздняя версия. Чтобы проверка номер сборки откройте Центр Администратор Windows и щелкните вопросительный знак в правом верхнем углу.

Если вы еще не сделали этого, создайте расширение средства для Центра Администратор Windows. После завершения работы запишите значения, используемые при создании расширения:

Значение	Объяснение	Пример
{!Company Name}	Название вашей компании (с пробелами)	Contoso
{!Tool Name}	Имя средства (с пробелами)	InstallOnNode

В папке расширения средства создайте папку Node ({!Tool Name}\Node). Все, что размещено в этой папке, будет скопировано на управляемый узел при использовании этого API. Добавьте все файлы, необходимые для вашего варианта использования.

Кроме того, создайте {!Tool Name}\Node\installNode.ps1 скрипт. Этот скрипт будет запущен на управляемом узле после копирования всех файлов из {!Tool Name}\Node папки в управляемый узел. Добавьте дополнительную логику для вашего варианта использования. Пример {!Tool Name}\Node\installNode.ps1 файла:

# Add logic for installing payload on managed node
echo 'Success'

Примечание.

{!Tool Name}\Node\installNode.ps1 имеет определенное имя, которое будет искать API. Изменение имени этого файла приведет к ошибке.

Интеграция с пользовательским интерфейсом

Обновите следующее:\src\app\default.component.ts

import { Component } from '@angular/core';
import { AppContextService } from '@microsoft/windows-admin-center-sdk/angular';
import { Observable } from 'rxjs';

@Component({
  selector: 'default-component',
  templateUrl: './default.component.html',
  styleUrls: ['./default.component.css']
})

export class DefaultComponent {
  constructor(private appContextService: AppContextService) { }

  public response: any;
  public loading = false;

  public installOnNode() {
    this.loading = true;
    this.post('{!Company Name}.{!Tool Name}', '1.0.0',
      this.appContextService.activeConnection.nodeName).subscribe(
        (response: any) => {
          console.log(response);
          this.response = response;
          this.loading = false;
        },
        (error) => {
          console.log(error);
          this.response = error;
          this.loading = false;
        }
      );
  }

  public post(id: string, version: string, targetNode: string): Observable<any> {
    return this.appContextService.node.post(targetNode,
      `features/extensions/${id}/versions/${version}/install`);
  }

}

Обновите заполнители до значений, которые использовались при создании расширения:

this.post('contoso.install-on-node', '1.0.0',
      this.appContextService.activeConnection.nodeName).subscribe(
        (response: any) => {
          console.log(response);
          this.response = response;
          this.loading = false;
        },
        (error) => {
          console.log(error);
          this.response = error;
          this.loading = false;
        }
      );

Также обновите следующее:\src\app\default.component.html

<button (click)="installOnNode()">Click to install</button>
<sme-loading-wheel *ngIf="loading" size="large"></sme-loading-wheel>
<p *ngIf="response">{{response}}</p>

И наконец \src\app\default.module.ts:

import { CommonModule } from '@angular/common';
import { NgModule } from '@angular/core';

import { LoadingWheelModule } from '@microsoft/windows-admin-center-sdk/angular';
import { DefaultComponent } from './default.component';
import { Routing } from './default.routing';

@NgModule({
  imports: [
    CommonModule,
    LoadingWheelModule,
    Routing
  ],
  declarations: [DefaultComponent]
})
export class DefaultModule { }

Создание и установка пакета NuGet

Последний шаг — создание пакета NuGet с добавленными файлами, а затем установка этого пакета в Центре Администратор Windows.

Следуйте инструкциям по расширению публикации , если вы еще не создали пакет расширения.

Внимание

В nuspec-файле для этого расширения важно, чтобы <id> значение соответствовало имени в проекте manifest.json и <version> соответствует добавленным значениям \src\app\default.component.ts. Кроме того, добавьте запись в <files>:

<file src="Node\**\*.*" target="Node" />.

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="https://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
  <metadata>
    <id>contoso.install-on-node</id>
    <version>1.0.0</version>
    <authors>Contoso</authors>
    <owners>Contoso</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <projectUrl>https://msft-sme.myget.org/feed/windows-admin-center-feed/package/nuget/contoso.sme.install-on-node-extension</projectUrl>
    <licenseUrl>http://YourLicenseLink</licenseUrl>
    <iconUrl>http://YourLogoLink</iconUrl>
    <description>Install on node extension by Contoso</description>
    <copyright>(c) Contoso. All rights reserved.</copyright>
  </metadata>
    <files>
    <file src="bundle\**\*.*" target="ux" />
    <file src="package\**\*.*" target="gateway" />
    <file src="Node\**\*.*" target="Node" />
  </files>
</package>

После создания этого пакета добавьте путь к этому веб-каналу. В Центре Администратор Windows перейдите к веб-каналам расширений > Параметры > и добавьте путь к этому пакету. После установки расширения вы сможете нажать install кнопку и вызвать API.