Araç uzantısı geliştirme

Araç uzantısı, kullanıcıların sunucu veya küme gibi bir bağlantıyı yönetmek için Windows Yönetim Merkezi ile etkileşim kurmalarının birincil yoludur. Windows Admin Center giriş ekranında bir bağlantıya tıklayıp bağlandığınızda, sol gezinti bölmesinde bir araç listesi gösterilir. Bir araca tıkladığınızda araç uzantısı yüklenir ve sağ bölmede görüntülenir.

Bir araç uzantısı yüklendiğinde, hedef sunucuda veya kümede WMI çağrılarını veya PowerShell betiklerini yürütebilir ve kullanıcı girişlerine göre kullanıcı arabiriminde bilgi görüntüleyebilir veya komutları yürütebilir. Araç uzantıları hangi çözümler için görüntülenmesi gerektiğini tanımlar ve bu da her çözüm için farklı bir araç kümesine neden olur.

Note

Farklı uzantı türleri hakkında bilgi sahibi değil misiniz? genişletilebilirlik mimarisi ve uzantı türleri hakkında daha fazla bilgi edinin.

Ortamınızı hazırlama

Henüz yapmadıysanız, tüm projeler için gereken bağımlılıkları ve genel önkoşulları yükleyerek ortamınızı hazırlayın.

Windows Admin Center SDK'sı ile yeni bir araç uzantısı oluşturma

Tüm bağımlılıkları yükledikten sonra yeni araç uzantınızı oluşturmaya hazır olursunuz. Proje dosyalarınızı içeren bir klasör oluşturun veya bu klasöre göz atın, bir komut istemi açın ve bu klasörü çalışma dizini olarak ayarlayın. Daha önce yüklenmiş olan Windows Admin Center SDK'sını kullanarak aşağıdaki söz dizimine sahip yeni bir uzantı oluşturun:

wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest

Value	Explanation	Example
{!Company Name}	Şirketinizin adı (boşluklu)	Contoso Inc
{!Tool Name}	Araç adınız (boşluklu)	Manage Foo Works

Aşağıda örnek bir kullanım verilmiştir:

wac create --company "Contoso Inc" --tool "Manage Foo Works" --version latest

Windows Admin Center SDK sürüm 6.0.0 ve üzerini kullanarak React tabanlı araç uzantıları da oluşturabilirsiniz. Aşağıdaki sözdizimi kullanarak yeni bir React tabanlı araç uzantısı oluşturun:

wac create-react --company "{!Company Name}" --tool "{!Tool Name}" --version latest

Value	Explanation	Example
{!Company Name}	Şirketinizin adı (boşluklu)	Contoso Inc
{!Tool Name}	Araç adınız (boşluklu)	Manage Foo Works

Bir örnek aşağıda verilmiştir:

wac create-react --company "Contoso Inc" --tool "Manage Foo Works" --version latest

Bu, aracınız için belirttiğiniz adı kullanarak geçerli çalışma dizini içinde yeni bir klasör oluşturur, gerekli tüm şablon dosyalarını projenize kopyalar ve dosyaları şirketinizin ve araç adınızla yapılandırılır.

Note

Bu komuttaki --version bayrağı, hedeflemek istediğiniz Windows Admin Center SDK sürümünü belirtir. Windows Admin Center SDK'nin başka bir sürümünü hedeflemenin yollarını okuyun ve uzantınızı en son SDK ve platform değişiklikleri ile güncel tutun.

Sonra, yeni oluşturulan klasöre geçin, ardından aşağıdaki komutu çalıştırarak gerekli yerel bağımlılıkları yükleyin.

npm install

Bu işlem tamamlandıktan sonra, yeni uzantınızı Windows Yönetim Merkezi'ne yüklemek için ihtiyacınız olan her şeyi ayarlamış olursunuz.

Eklentinize içerik ekleyin

Artık Windows Admin Center SDK'sı ile bir uzantı oluşturduğunuza göre içeriği özelleştirmeye hazırsınız. Yapabileceklerine ilişkin örnekler için şu kılavuzlara bakın:

• Boş modül ekleme
• iFrame ekleme

Geliştirici Kılavuzumuzda daha fazla örnek bulabilirsiniz. Developer Kılavuzu, Windows Yönetim Merkezi'ne yan yüklenebilecek tamamen işlevsel bir çözüm uzantısıdır ve kendi uzantınıza entegre edebileceğiniz örnek işlevsellik ve araç örneklerinin zengin bir koleksiyonunu içerir.

Windows Yönetim Merkezi ayarlarınızın Gelişmiş sayfasında Geliştirici Kılavuzu uzantısını etkinleştirin.

Uzantınızın simgesini özelleştirme

Araç listesinde uzantınız için görüntülenen simgeyi özelleştirebilirsiniz. Bunu yapmak için uzantınızın içindeki tüm icon girişleri manifest.json değiştirin:

"icon": "{!icon-uri}",

Value	Explanation	Örnek uri
{!icon-uri}	Simge kaynağınızın konumu	assets/foo-icon.svg

NOT: Şu anda uzantınızı geliştirme modunda dışarıdan yüklerken özel simgeler görünmez. Geçici bir çözüm olarak, içeriğini target aşağıdaki gibi kaldırın:

"target": "",

Bu yapılandırma yalnızca geliştirme modunda dışarıdan yükleme için geçerlidir, bu nedenle uzantınızı yayımlamadan önce içindeki target değeri korumak ve sonra geri yüklemek önemlidir.

Uzantınızı derleme ve yan yükleme

Sonra, uzantınızı Windows Admin Center'a entegre edin ve yan yüklemeyi yapın. Bir komut penceresi açın ve kaynak dizininize dizininizi değiştirin.

• Uzantını oluşturmak ve hizmet vermek için aşağıdaki komutu çalıştırın:

  npm run build
  npm start
  

Bu terminali çalışır tutun.

Varsayılan olarak, uzantı 4200 portunda yan yüklenir. Portu değiştirmek için uzantılarınızı package.json ve appsettings.json dosyalarınızı değiştirin. Windows Admin Center'ın çalıştığı portu kullanmadığınızdan emin olun.

Projenizi test amacıyla Windows Admin Center’ın yerel bir örneğine yandan yüklemek için, yerel olarak sunulan projeyi bağlayın.

• Web tarayıcısında Windows Yönetim Merkezi'ni başlatma

• Hata ayıklayıcısını açma (F12)

• Konsolu açın ve localhost üzerinden sideload etmek için aşağıdaki komutu girin:

  MsftSme.sideLoad("http://localhost:4200")
  

  FQDN kullanarak uygulamayı yandan yükleme yönergelerini izlediyseniz, konsolu açın ve aşağıdaki komutu yazın:

  MsftSme.sideLoad("http://<FQDN>:4200")
  

• Web tarayıcısını yenileyin.

Projeniz şimdi Araçlar listesinde isimin yanında (side loaded) ile görünüyor.