Przejdź do głównej zawartości

AppCmd - zarządzanie IIS z wiersza poleceń w Windows Server

Zarządzanie usługami IIS z poziomu GUI jest dziecinnie proste. Od wersji 7.0 wszystkie opcje są łatwo dostępne i zarządzanie jest niezmiernie proste. Oczywiście interfejs graficzny nie zawsze jest wygody w pewnych zastosowaniach. Do napisania skryptu zarządzającego witryną czy pulą aplikacji łatwiej użyć oczywiście wiersza poleceń. W tym momencie z pomocą przychodzi narzędzie AppCmd - administracja IIS z poziomu konsoli bez użycia graficznego środowiska Menadżera.

AppCmd pozwala na na:

  • Tworzenie i konfigurowanie witryn, pól aplikacji, katalogów wirtualnych

  • Zatrzymywanie i wznawianie witryn

  • Zatrzymywanie, wznawianie i odtwarzanie pól aplikacji

  • Podgląd procesów

  • Analiza reqestów aplikacji na serwerze IIS

  • Zarządzanie i backup konfiguracji aplikacji

  • Mechanizm potoków

AppCmd.exe znajduje się w folderze %windir%\system32\inetsrv . Powyższa ścieżka nie istnieje w zmiennej path , a zatem aby ułatwić pracę, można ją tam dopisać. Dzięki temu zabiegowi uzyskamy dostęp do aplikacji z każdej lokacji.

Składnia

Narzędzie AppCmd działa poprzez wydanie odpowiednich poleceń ( command ) dla obiektów ( object-type ) z opcjonalnymi parametrami ( parameter1:value1 ... ):

appcmd (command) (object-type) <identifier> </parameter1:value1 ...>

Obiektem może być: SITE, APP, VDIR, APPPOOL, CONFIG, WP, REQUEST, MODULE, BACKUP, TRACE. W zależności od wybranego obiektu, posiada on własną listę komend, jaką można użyć. Najłatwiej przejrzeć ją poprzez zapytanie:

appcmd (object-type) /?

O parametrach do komend, najszybciej dowiemy się poprzez polecenie:

appcmd (command) (object-type) /? 

Przykłady

Teoria już za nami. Przejdźmy do kilku przykładów które pokarzą możliwości AppCmd, a także najbardziej przydatne polecenia. Część poleceń np. delete , czy set , jest analogiczna dla większości obiektów i nie ma potrzeby powtarzania ich dla każdej z opcji.

Witryny

  • lista witryn
appcmd list sites

Jeśli dodamy np. parametr /state:Started , otrzymamy listę z tylko aktywnymi witrynami. Listę możemy filtrować również za pomocą innych parametrów (patrz następny podpunkt).

  • dodanie witryny
appcmd add site /name:Test /id:10 /bindings:"http/*:95:" /physicalPath:"c:\PUB\d1" 

name - nazwa witryny, id - identyfikator witryny, bindings - powiązania (w tym przypadku dostęp przez port 95)

  • zmiana parametrów
appcmd set site Test /id:20 
  • usuwanie
appcmd delete site Test

Aplikacje

Mając już witrynę możemy pobawić się z aplikacjami w jej obrębie.

  • dodanie aplikacji
appcmd add app /site.name:Test /path:/a1 /physicalPath:"c:\PUB\d1\a1"

site.name - witryna, path - ścieżka wirtualna (w tym przypadku będzie to a1, czyli dostęp będzie poprzez adres: http://adres:95/a1 ), physicalPath - ścieżka fizyczna do folderu z plikami

Pule aplikacji

  • dodanie puli aplikacji

appcmd add apppool /name:apool

Dodaliśmy własną pulę aplikacji o nazwie apool .

  • podgląd puli aplikacji
appcmd list apppool "apool" /text:*

Na wyjściu otrzymamy podgląd konfiguracji puli aplikacji:


APPPOOL
  APPPOOL.NAME:"apool"
  PipelineMode:"Integrated"
  RuntimeVersion:"v4.0"
  state:"Started"
  [add] 
    name:"apool" 
    queueLength:"1000" 
    autoStart:"true" 
    enable32BitAppOnWin64:"false" 
    managedRuntimeVersion:"v4.0" 
(...)

  • edycja Dowolny parametr edytujemy w następujący sposób:
appcmd set apppool "apool" /autoStart:"false"

Foldery wirtualne

  • tworzenie folderu
appcmdadd vdir /app.name:"Test/a1" /path:/a2 /physicalPath:"c:\PUB\d1\a2"

Powyższe polecenie w naszym przypadku utworzyło wirtualną ścieżkę dla Test/a1 .

  • listowanie
appcmd list vdir /physicalPath:"c:\PUB"

Pomimo, iż listowanie, w każdym przypadku wygląda podobnie, to dzięki parametrom, można odfiltrować dane wg potrzeb. Tutaj tylko te witryny, które znajdują się fizycznie, w określonym folderze.

Backup

Dzięki appcmd w prost sposób wykonany backup konfiguracji serwera:

  • backup
appcmd add backup "b20120116"
  • przywrócenie kopii
appcmd restore backup "b20120116"

Procesy

  • analiza procesów Obiekt wp pozwala w prosty sposób na podgląda działających procesów. Poniższe polecenia listują wszystkie procesy działające na domyślnej puli aplikacji:
appcmd list wps /apppool.name:DefaultAppPool

lub dziłające na okreslonym numerze PID:

appcmd list wp "35674"

Śledzenie witryn

Ciekawym obiektem jest trace to śledzenia witryn. Można w prosty sposób przeanalizować działanie witryn pod kątem błędów.

  • dodanie witryny do śledzenia
appcmd configure trace "Test" /enablesite

Dodaliśmy śledzenie dla witryny Test .

  • podgląd logu Aby podejrzeć działanie trace , na początku należy wylistować logi (pliki XML):
appcmd list traces

Z logów wybieramy ten, który nas interesuje i wyświetlamy go

appcmd list trace "id_logu.xml" /text:path

Potoki

Dzięki zaimplementowanemu mechanizmowi potoków, można jeszcze więcej wycisnąć z appcmd. Oto kilka bardziej zaawansowanych przykładów, które wykorzystują potoki (dla ułatwienia analizy, dodałem linie nowych znaków pomiędzy potokami):

  • szybkie uruchomianie nieaktywnych witryn
appcmd list site /state:stopped /xml 
| appcmd start site /in

Listujemy witryny nieaktywne (wyjście w formacie /xml ) i wrzucamy je jako wejście ( /in ) do polecenia uruchomienia witryn.

  • recycling puli aplikacji, dla witryn które generują błąd 500
appcm list trace /statusCode:500 /xml 
| appcmd list apppool /in /xml 
| appcmd recycle apppool /in

W tym przypadku listujemy witryny, generujące błąd 500, następnie przekazujemy je do list apppool w celu uzyskania odpowiednich pól aplikacji i na koniec robimy recycling tych puli.

Podsumowanie

AppCmd to potężne narzędzie do zarządzania IIS z konsoli, w przypadku gdy np. nie możemy skorzystać z graficznego odpowiednika. Przedstawiłem zaledwie kilak podstawowych i najprzydatniejszych funkcji. Jeszcze jest wiele do odkrycia. Cieszy duża gama opcji i co najważniejsze, mechanizm potoków, który jest tu wręcz niezbędny.

Komentarze

Popularne posty z tego bloga

Licznik Blogowy - wersja 0.6, czyli własne statystyki i wykresy tuż pod ręką

Zapewne wielu z Was pamiętam, a może i używa:) , mojej wtyczki Licznik Blogowy do najpopularniejszych przeglądarek, skierowanej do blogerów na portalu dobreprogramy.Jeśli ktoś nie kojarzycie, to w skrócie: Licznik Blogowy to wtyczka do Chroma/Opery/Firefoxa. Za jej pomocą przejrzycie szybko pełne statystyki swoich wpisów na blogu. Lista wpisów może być sortowana wg: ilości wyświetleń, ilości komentarzy, daty publikacji i adnotacji moderacji. Łatwo znajdziecie publikacje, oznaczone przez moderatorów, a to wszystko w estetycznej i miłej formie, dostosowanej do wybranej skórki na blogu.Licznik Blogowy 0.6 - czas na własne wykresy! :)Ostatnia odsłona wtyczki przyniosła ciekawe refleksje po rozmowie z szanownym Panem Mordziem. Zaproponował on, aby wtyczka mogła generować wykresy na podstawie zebranych danych. Pomysł wydał mi się niezmiernie interesujący, stąd też obecna aktualizacja (0.6) przynosi możliwość tworzenia wykresów, opierając się na zabranych danych.Używanie nowej funkcji jes…

Humble Voxatron Debut + tanie gry

Ponownie The Humble Indie Bundle atakuje nas świetną promocją.W skrócie czym jest Humble Indie Bundle:kupujesz gry za dowolne pieniądzegry są multiplatformowebrak zabezpieczeńpieniądze idą m.in. na cele charytatywnePod http://www.humblebundle.com/ znajdziecie więcej szczegółów.W nowej odsłonie The Humble Indie Bundle, która obecnie zwie się: Humble Voxatron Debut możemy otrzymać Voxatron, a także jeśli wpłata przekroczy średnią aktualnych wpłat: The Binding of Isaac i Blocks That Matter.VoxatronTytułowa pozycja to strzelanka z rzutem izometrycznym. Grę otrzymujemy w wersji alfa. Jest to jednocześnie pra-premiera. Nie posiada ona jednak jakiś znaczących defektów, przez co można spokojnie grać :) Mamy również gwarancję, iż będziemy dostawać wszelkie aktualizacje i dodatki, jakie otrzyma.Voxatron przy pierwszym uruchomieniu zachwyca, śwetną oprawą muzyczną. Tytułowy motyw z menu, przypomina stare czasy, kiedy muzykę z menu nuciło się jeszcze długo po tym jak wyłączyliśmy grę.Nie sposób …

222 polskie gry, które warto znać - Marcin Kosman, recenzja książki

Marcin Kosman dał się poznać jako autor ciekawej pozycji o polskim game devie: "Nie tylko Wiedźmin. Historia polskich gier komputerowych". Po pięciu latach wraca z nową książką, również związaną z polską branżą grową, ale w zupełnie innej formie.222 polskie gry"222 polskie gry, które warto znać" to wyjątkowa książka. Co więcej, to nie jest książka jako taka, a bliżej jej do albumu. W języku angielskim funkcjonują one jako tzw. "Coffee table books", czyli książki/albumy bardziej do oglądania, niż do czytania.Tak jest właśnie z omawianą pozycją. W twardych okładach, w formacie B5 i na pięknym, kredowym papierze, znalazło się 222 polskich gier z lat 1983-2019. Każda strona to duża grafika, z kilkoma zdaniami o grze od autora książki, a czasem również dodatkowy, akapitem od osób tworzących dany kawałek softu.Wybór gier jest na tyle szeroki, że można śmiało powiedzieć, iż wybrano faktycznie najbardziej znaczące i rozpoznawalne tytuły. Jako, że przygodę zacząłe…

Nokia Lumia 900 - recenzja najmocniejszego smartfona od Finów

Za nami już prezentacja nowego Windows Phone 8 oraz kilku urządzeń działających pod tym systemem. Takie cuda jak Nokia Lumia 920 / 820, HTC 8X / 8S, czy sporych rozmiarów Samsung Ativ S (4.8 calowy ekran) są marzeniem wielu z nas. Obecnie jednak ceny są dość wysokie (chociaż HTC 8S ma być już za 1300 zł..., tylko to nie Lumia... o czym na końcu tego wpisu), a i dostępność urządzeń na naszym rynku pozostawia wiele do życzenia. Cóż można zrobić w takiej sytuacji? Otóż nic nie stoi na przeszkodzie, aby zakupić jedną z najlepszych słuchawek jakie wyszły w tym roku. Mowa oczywiście o Nokia Lumia 900, która pomimo tego, iż posiada Windows Phone 7, jest niesamowicie warta uwagi. Czym się charakteryzuje? Czy warto ją kupić? Jakie ma wady i zalety? Na te i inne pytania znajdziesz odpowiedź w tym wpisie. Zapraszam!HardwareNokia Lumia 900 jest najwyższym modelem od Finów. Moim skromnym zdaniem, to również najbardziej atrakcyjne urządzenie pracujące na Windows Phone 7, ale o tym za chwilę. "…

Windows Phone 7 w LG E900

Na wstępie dziękuje za zaproszenie na HotZlot. To było niesamowite przeżycie! Możliwość porozmawiania z ludźmi z redakcji i z czytelnikami dobrych programów, których znało się jedynie z xywek/avatarów - bezcenne :) Wpis nigdy by nie powstał, gdyby nie konkurs na Kinecta, gdzie udało mi się wywalczyć w boksie - LG z Windows Phone 7 :) Pozdro dla wszystkich uczestników konkursu :)Pierwsze kroki w Windows Phone 7Windows Phone 7 miałem okazje zobaczyć już w okolicach października/listopada 2010. W większości przeważały opinie, iż jest brzydki i mało intuicyjny. Wówczas po minucie spędzonej z nim, nie można było myśleć inaczej.Teraz mając go już dłużej, dochodzę do wniosku, iż jest on... na swój sposób piękny;) Po pierwszym uruchomieniu widzimy ekran główny z kafelkami. Zaskoczeniem jest, to iż nie ma znanego wszystkim pulpitu jak z Androida. Przypomina to raczej iOS. Tutaj jednak postawiono na przejrzystość i funkcjonalność.Na wstępnie dodam, iż telefon został zaktualizowany do najnowsz…

Windows Phone 7 - aplikacje na start

Czekając na premierę aktualizacji Mango do Windows Phone 7, która ma być wydana już na dniach, postanowiłem stworzyć wpis, opisujący aplikacje (darmowe) warte zainstalowania na swoim smartfonie.Jeśli nie wiesz co zainstalować "na dzień dobry" w Windows Phone 7, szukasz jakiś ciekawych aplikacji na swojego smartfona lub po prostu chcesz być na bieżąco z softem - ten wpis jest dla Ciebie! :) Smacznego ;)linki prowadzą do aplikacji Zune; jeśli nie ma linku to znaczy, że program nie był dostępny poprzez Zune, ale można go pobrać bezpośrednio z Marketplaceśrednia ocen i ilość recenzji dla każdego programu były brane z AppFlowMarketplace - wyszukiwarki (gorąco polecam!)AppFlow Ocena: 4,70/5 Recenzji: 230 Genialny program do wyszukiwania w Marketplace. To jest ta aplikacja od której warto zacząć przygodę z Windows Phone 7. Do wybory Top50 w następujących kategoriach:Top Indie Games- najlepsze gry niezależne,Top XBox Games - najlepsze gry na platformę Xbox na WP7,New & Impre…

Dysk SSD z Windows - konfiguracja

Wpis chcę zacząć od złożenia podziękowań na ręce Redakcji dobrychprogramów za wyróżnienie "bloger kwartału" i nagrodzenie dyskiem SSD (Kingston SSDNow V+100 96 GB - miodzio). Bardzo dziękuję za docenienie takiego szaraczka jak ja :) Mam nadzieję, że będę miał szansę się wyróżnić (i zasłużyć na wyróżnienie:P) oraz na to, aby zaskoczyć zarówno czytelników dobrychprogramów jak i Redakcję :)Kingston SSDNow V+100 96 GB - to nie jest recenzjaNie chce się powtarzać pisząc recenzję dysku SSD, którą zrobił już wcześniej Ave5 /pozdrawiam %) /. Różnica jest jedynie w większej pojemności.Ten wpis chciałbym poświecić konfiguracji dysku pod Windowsami. Ze względu na to, iż charakterystyka SSD wymusza pewnie działa, które dla dysku HDD nie miałyby sensu, a nawet powodowałyby spadek wydajności. Zanim jednak przejdę do optymalizacji...Krótko dodam kilka spostrzeżeń, odnośnie dysku SSD. Podczas zwykłem pracy, nie czuć przycięć i charakterystycznego dla dysków HDD, doczytywania danych, przy d…

Bazaar - alternatywny Windows Phone Marketplace z PC!

O Bazaar można było już usłyszeć. Jest to alternatywny Marketplace dla Windows Phone, który jest zbiorem aplikacji, których próżno szukać w Microsoftowym sklepie. W jednym miejscu otrzymujemy zbiór programów typu homebrew.Do tej pory był on dostępny jedynie poprzez aplikację instalowaną na odblokowane urządzenia z Windows Phone. Aby móc z niego ściągać na smartfona, należało mieć w pełni odblokowany system, wymagało to jednak przeinstalowania firmwareu na odpowiednio zmodyfikowany. Nie każdy chciał, ale i mógł to zrobić, gdyż jedynie kilka urządzeń doczekało się zmodyfikowanego systemu Windows Phone.Na szczęście ukazała się aplikacja desktopowa na Windowsa (do pobrania tutaj ), która pozwala na instalowanie aplikacji homebrew na urządzenia odblokowane już nawet developersko! Nic nie stoi na przeszkodzie, aby móc zapoznać się z alternatywnym Marketplace!Aby móc korzystać z Bazaar for PC potrzebujemy:odblokowany telefon (developersko+)Zune na PCzainstalowane Windows Phone SDKBazaar for…

Programistok - Białystok dla programistów i nie tylko

W Białymstoku powstała bardzo ciekawa inicjatywa promująca nowe technologie i trendy w programowaniu - Programistok. (Programistok na Facebooku: http://www.facebook.com/pages/Programistok/237808102923666 )Cykliczne spotkania będą omawiać m.in. programowanie na urządzenia mobilne, testowanie aplikacji, projektowanie interfejsów użytkownika czy pisanie lepszego, czystszego kodu. Każdy zainteresowany może zgłosić swoją propozycjię prezentację (20 - 30 minut).Impreza organizowana przy udziale firmy AmberBit (http://amberbit.com/ )Cele jakie przyświecają Programistokowi:integracja podlaskiego (i nie tylko) środowiska programistów poprzez wymianę pomysłów, doświadczeń wśród wielu różnych technologii związanych z internetem - nie ma narzędzi idealnych, każdy projekt warto rozpatrzyć indywidualniena spotkaniu są różnorodni ludzie, więc dobra okazja na poszukanie nowej pracy lub znalezienie pracownikaspotkanie raz w miesiącu w luźnej atmosferze (Pub Mao, Młynowa 44, http://www.mao.com.pl/ )…

Zdrowa praca przy komputerze cz. 2 - Urządzenia wspomagające

Postanowiłem dodać, króciutki wpis o pewnym małym urządzeniu, które zakupiłem kilka lat temu, pod wpływem artykułu w gazecie (niech mają! :P) CD-ACTION. Recenzent zachwycał się kuleczką, którą kręcił w dłoni. Uznałem to za kolejny zbędny gadżet, aż do momentu, gdy uświadomiłem, sobie, iż jestem w grupie podwyższonego ryzyka narażonego na zespół cieśni nadgarstka. Poza tym zbliżały się Święta i pomyślałem, że kupie sobie coś ciekawego (ile można dostawać skarpet i krawatów :P)Zespół cieśni nadgarstkaStan chorobowy tworzy się w wyniku długotrwałego nacisku na nerw pośrodkowy, biegnący w kanale nadgarstka. Powstaje ona często, gdy wykonujemy te same czynności ruchowe. W naszym przypadku na wskutek długotrwałego pisania na klawiaturze / używania myszki bez specjalnych podkładek.Objawy zespołu cieśni nadgarstka:osłabienie chwytuproblemy z zaciśnięciem ręki w pięśćmrowienie / bóle w nadgarstku / palcachosłabione czucie w palcachwypadanie trzymanych przedmiotów z rękiObjawy często pojawiają…