Instalacja ról i funkcji Windows Server poleceniem Install-WindowsFeature

Jak instalować role i funkcje Windows Server przez Install-WindowsFeature: nazwy funkcji, narzędzia administracyjne, źródło plików, zdalnie i z XML.

  • Windows Server · Role i funkcje
  • Poziom: średni
  • Czas: 15–30 minut
  • Install-WindowsFeature
  • Get-WindowsFeature
  • Uninstall-WindowsFeature

Na czym polega problem

Kreator dodawania ról w Menedżerze serwera wystarcza przy jednym serwerze, ale gdy maszyn jest kilka albo pracujesz na Server Core, znacznie szybciej idzie to z PowerShella. Moduł ServerManager daje trzy podstawowe polecenia: Get-WindowsFeature pokazuje listę ról i funkcji razem z ich stanem, Install-WindowsFeature je dodaje, a Uninstall-WindowsFeature usuwa.

Kłopoty rzadko wynikają z samego polecenia. Zwykle chodzi o szczegóły: nazwy techniczne różnią się od tych w kreatorze, konsole administracyjne nie dochodzą same, a część funkcji potrzebuje plików z nośnika instalacyjnego. Poniżej pokazujemy, jak zrobić to porządnie – lokalnie, zdalnie i na kilku serwerach jednocześnie.

Opis dotyczy Windows Server 2016, 2019, 2022 i 2025. Na Windows 10 i 11 polecenie pojawia się dopiero po doinstalowaniu narzędzi RSAT i służy wtedy do zarządzania zdalnym serwerem albo plikiem VHD, a nie samym komputerem klienckim.

Objawy

  • Wynik polecenia pokazuje Success = False i informację, że instalacja jednej lub kilku ról się nie powiodła.
  • Rola działa, ale w menu Narzędzia w Menedżerze serwera brakuje konsoli do jej obsługi.
  • Przy funkcjach takich jak .NET Framework 3.5 pojawia się komunikat o braku plików źródłowych (The source files could not be found).
  • Kolumna Restart Needed ma wartość Yes i nowa rola nie odpowiada do czasu ponownego uruchomienia.
  • Na stacji roboczej PowerShell zgłasza, że nie rozpoznaje polecenia Install-WindowsFeature.

Najczęstsze przyczyny

  1. Podanie nazwy wyświetlanej w kreatorze zamiast nazwy technicznej, np. „Serwer sieci Web (IIS)” zamiast Web-Server.
  2. Brak parametru -IncludeManagementTools – w PowerShellu konsole MMC i moduły administracyjne nie są dodawane domyślnie.
  3. Funkcja ma usunięte pliki (stan Removed) albo należy do funkcji na żądanie i wymaga wskazania źródła.
  4. Oczekujący restart po wcześniejszych aktualizacjach, który blokuje kolejne zmiany w magazynie składników.
  5. Uruchomienie polecenia bez uprawnień administratora lub na systemie klienckim bez RSAT.

Rozwiązanie krok po kroku

  1. Sprawdź nazwy i stan funkcji

    Otwórz PowerShell jako administrator i wyświetl listę. Kolumna Name zawiera nazwę, której używasz w poleceniach, a Install State mówi, czy funkcja jest zainstalowana (Installed), dostępna (Available), czy jej pliki usunięto z dysku (Removed). Gwiazdki w nazwie pozwalają szybko zawęzić wynik.

    Get-WindowsFeature | Where-Object Installed
    Get-WindowsFeature -Name *Web*
  2. Zrób próbę bez zmian w systemie

    Parametr -WhatIf pokazuje, co zostałoby doinstalowane razem z wybraną rolą, łącznie z zależnościami. To dobry nawyk na serwerze produkcyjnym, bo od razu widzisz, czy rola nie pociągnie za sobą czegoś, czego nie chcesz.

    Install-WindowsFeature -Name Web-Server -IncludeManagementTools -WhatIf
  3. Zainstaluj rolę razem z narzędziami

    Dodaj -IncludeManagementTools, żeby dostać konsolę i moduł PowerShell. Parametru -IncludeAllSubFeature używaj ostrożnie – instaluje wszystkie podfunkcje, także te, których nikt nie potrzebuje, co powiększa powierzchnię ataku. Po zakończeniu sprawdź kolumny Success, Restart Needed i Exit Code. Jeśli możesz zrestartować serwer od razu, dopisz -Restart.

    Install-WindowsFeature -Name Web-Server -IncludeManagementTools
  4. Wskaż źródło plików, gdy system go wymaga

    Podłącz ISO tej samej wersji Windows Server i podaj folder sources\sxs albo plik install.wim z numerem obrazu. Numer odczytasz poleceniem Get-WindowsImage. Jeżeli źródło leży w udziale sieciowym, prawo odczytu musi mieć konto komputera docelowego, a nie tylko Twoje konto.

    Get-WindowsImage -ImagePath D:\sources\install.wim
    Install-WindowsFeature -Name NET-Framework-Core -Source D:\sources\sxs
  5. Instaluj zdalnie na innym serwerze

    Parametr -ComputerName działa także wtedy, gdy serwera nie dodano do Menedżera serwera – wystarczy działający WinRM i uprawnienia administratora. Na Server Core graficzne konsole się nie zainstalują, pojawią się tylko narzędzia wiersza poleceń, dlatego konsolę dodaj na serwerze, z którego zarządzasz.

    Install-WindowsFeature -Name Print-Server -ComputerName SRV02
  6. Powtórz tę samą konfigurację na kilku maszynach

    W kreatorze, na stronie potwierdzenia, wybierz eksport ustawień konfiguracji do pliku XML. Plik podasz potem w parametrze -ConfigurationFilePath dla kolejnych serwerów. Wszystkie muszą mieć tę samą wersję systemu co serwer, z którego uruchamiasz polecenie.

    Install-WindowsFeature -ConfigurationFilePath C:\Konfig\DeploymentConfigTemplate.xml -ComputerName SRV03 -Restart
  7. Usuwaj role świadomie

    Uninstall-WindowsFeature wyłącza rolę, ale jej pliki zostają w magazynie składników. Dopisanie -Remove kasuje też pliki i zmienia stan na Removed – ponowna instalacja będzie wtedy wymagała parametru -Source. Usunięcie roli zwykle kończy się restartem, więc planuj je na okno serwisowe.

    Uninstall-WindowsFeature -Name Web-Server -IncludeManagementTools

Jak zapobiegać

  • Trzymaj ISO w wersji zgodnej z serwerami w udziale, do którego konta komputerów mają prawo odczytu.
  • Przed każdą instalacją na produkcji uruchamiaj polecenie z -WhatIf.
  • Instaluj tylko potrzebne podfunkcje zamiast całego drzewa przez -IncludeAllSubFeature.
  • Po każdej zmianie eksportuj listę zainstalowanych funkcji do dokumentacji serwera.

W firmie

Na firmowych serwerach role dokładano latami i często nikt już nie pamięta, co jest zainstalowane i po co. Zanim dodasz kolejną, zapisz wynik Get-WindowsFeature do pliku – to najprostsza dokumentacja i punkt odniesienia po awarii. Unikaj łączenia na jednej maszynie ról o różnym poziomie ryzyka, np. kontrolera domeny z aplikacją wystawioną do internetu, i planuj instalacje na czas, gdy restart nikomu nie przeszkodzi. Jeśli chcesz, żeby ktoś uporządkował role i spisał konfigurację, zajmujemy się administracją serwerami w Warszawie, a zdalnie także w innych miastach.

Pytania i odpowiedzi

Czym różni się Install-WindowsFeature od Add-WindowsFeature?

Add-WindowsFeature to nazwa z Windows Server 2008 R2. W nowszych wersjach działa jako alias nowego polecenia, więc wynik jest ten sam, ale w skryptach lepiej używać aktualnej nazwy Install-WindowsFeature.

Dlaczego po instalacji roli z PowerShella nie widzę jej konsoli?

Bo bez parametru -IncludeManagementTools PowerShell dodaje samą rolę. Doinstaluj narzędzia tym samym poleceniem z tym parametrem albo wybierz w kreatorze funkcję z grupy Narzędzia administracji zdalnej serwera.

Czy mogę dodać rolę na Server Core z innego serwera?

Tak. Użyj -ComputerName w PowerShellu albo dodaj serwer do Menedżera serwera i uruchom kreator dla niego. Pamiętaj tylko, że konsoli graficznej na Core nie uruchomisz – zarządzasz rolą zdalnie.

Źródła

Opracowanie: zespół REDBAX – serwis komputerowy i obsługa informatyczna firm, Warszawa-Wawer. Stan na 31.10.2026. Kroki wykonujesz na własną odpowiedzialność – przed zmianami w systemie zrób kopię ważnych danych.

Serwer stoi, a firma czeka?

Administrujemy serwerami Windows w firmach z Warszawy i okolic. Zdiagnozujemy problem zdalnie, a gdy trzeba – przyjedziemy.