Udostępnij za pośrednictwem

Get-Service

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

Pobiera usługi na komputerze.

Składnia

Get-Service
   [[-Name] <String[]>]
   [-DependentServices]
   [-RequiredServices]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [<CommonParameters>]
Get-Service
   [-DependentServices]
   [-RequiredServices]
   -DisplayName <String[]>
   [-Include <String[]>]
   [-Exclude <String[]>]
   [<CommonParameters>]
Get-Service
   [-DependentServices]
   [-RequiredServices]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-InputObject <ServiceController[]>]
   [<CommonParameters>]

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie Get-Service cmdlet pobiera obiekty reprezentujące usługi na komputerze, w tym uruchomione i zatrzymane usługi. Domyślnie po Get-Service uruchomieniu bez parametrów zwracane są wszystkie usługi komputera lokalnego.

Możesz kierować to polecenie cmdlet, aby uzyskać tylko określone usługi, określając nazwę usługi lub nazwę wyświetlaną usług. Można też przekazać do tego polecenia cmdlet obiekty usługi.

Przykłady

Przykład 1: Pobieranie wszystkich usług na komputerze

Ten przykład pobiera wszystkie usługi na komputerze. Zachowuje się tak, jakby wpisana wartość Get-Service *. Na ekranie domyślnym jest wyświetlany stan, nazwa usługi i nazwa wyświetlana każdej usługi.

Get-Service

Przykład 2. Pobieranie usług rozpoczynających się od ciągu wyszukiwania

W tym przykładzie są pobierane usługi z nazwami usług rozpoczynającymi się WMI od (Instrumentacja zarządzania Windows).

Get-Service "wmi*"

Przykład 3. Wyświetlanie usług zawierających ciąg wyszukiwania

W tym przykładzie są wyświetlane usługi z nazwą wyświetlaną zawierającą wyraz network. Wyszukiwanie nazwy wyświetlanej znajduje usługi związane z siecią nawet wtedy, gdy nazwa usługi nie zawiera Netelementu , takiego jak xmlprov, usługa Network Provisioning Service.

Get-Service -Displayname "*network*"

Przykład 4. Pobieranie usług rozpoczynających się od ciągu wyszukiwania i wykluczenia

Ten przykład pobiera tylko usługi z nazwami usług, które zaczynają się od win, z wyjątkiem usługi WinRM.

Get-Service -Name "win*" -Exclude "WinRM"

Przykład 5. Wyświetlanie usług, które są obecnie aktywne

W tym przykładzie są wyświetlane tylko usługi ze stanem Running.

Get-Service | Where-Object {$_.Status -eq "Running"}

Get-Service pobiera wszystkie usługi na komputerze i wysyła obiekty w dół potoku. Polecenie Where-Object cmdlet wybiera tylko usługi z właściwością Status , która jest Runningrówna .

Stan to tylko jedna właściwość obiektów usługi. Aby wyświetlić wszystkie właściwości, wpisz Get-Service | Get-Member.

Przykład 6. Wyświetlanie listy usług na komputerze z usługami zależnymi

W tym przykładzie są pobierane usługi, które mają usługi zależne.

Get-Service |
  Where-Object {$_.DependentServices} |
    Format-List -Property Name, DependentServices, @{
      Label="NoOfDependentServices"; Expression={$_.dependentservices.count}
    }

Name                  : AudioEndpointBuilder
DependentServices     : {AudioSrv}
NoOfDependentServices : 1

Name                  : Dhcp
DependentServices     : {WinHttpAutoProxySvc}
NoOfDependentServices : 1
...

Polecenie Get-Service cmdlet pobiera wszystkie usługi na komputerze i wysyła obiekty w dół potoku. Polecenie Where-Object cmdlet wybiera usługi, których właściwość DependentServices nie ma wartości null.

Wyniki są wysyłane w dół potoku Format-List do polecenia cmdlet. Parametr Property wyświetla nazwę usługi, nazwę usług zależnych i właściwość obliczeniową, która wyświetla liczbę usług zależnych dla każdej usługi.

Przykład 7. Sortowanie usług według wartości właściwości

W tym przykładzie pokazano, że podczas sortowania usług w kolejności rosnącej według wartości właściwości Status zatrzymane usługi są wyświetlane przed uruchomieniem usług. Dzieje się tak, ponieważ wartość statusu to wyliczenie, w którym Stopped ma wartość 1, i Running ma wartość 4. Aby uzyskać więcej informacji, zobacz ServiceControllerStatus.

Aby najpierw wyświetlić listę uruchomionych usług, użyj parametru Sort-Object Descending polecenia cmdlet.

Get-Service "s*" | Sort-Object status

Status   Name               DisplayName
------   ----               -----------
Stopped  stisvc             Windows Image Acquisition (WIA)
Stopped  SwPrv              MS Software Shadow Copy Provider
Stopped  SysmonLog          Performance Logs and Alerts
Running  Spooler            Print Spooler
Running  srservice          System Restore Service
Running  SSDPSRV            SSDP Discovery Service
Running  ShellHWDetection   Shell Hardware Detection
Running  Schedule           Task Scheduler
Running  SCardSvr           Smart Card
Running  SamSs              Security Accounts Manager
Running  SharedAccess       Windows Firewall/Internet Connectio...
Running  SENS               System Event Notification
Running  seclogon           Secondary Logon

Przykład 8. Pobieranie usług zależnych usługi

W tym przykładzie są pobierane usługi wymagane przez usługę WinRM. Zwracana jest wartość właściwości ServicesDependedOn usługi.

Get-Service "WinRM" -RequiredServices

Przykład 9. Uzyskiwanie usługi za pośrednictwem operatora potoku

Ten przykład pobiera usługę WinRM na komputerze lokalnym. Ciąg nazwy usługi, ujęty w cudzysłów, jest wysyłany w dół potoku do Get-Service.

"WinRM" | Get-Service

Parametry

-DependentServices

Wskazuje, że to polecenie cmdlet pobiera tylko usługi, które zależą od określonej usługi.

Typ:SwitchParameter
Aliasy:DS
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

Określa, jako tablicę ciągów, nazwy wyświetlane usług do pobrania. Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Exclude

Określa jako tablicę ciągów usługę lub usługi, które to polecenie cmdlet wyklucza z operacji. Wartość tego parametru kwalifikuje parametr Name . Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Include

Określa jako tablicę ciągów usługę lub usługi, które to polecenie cmdlet zawiera w operacji. Wartość tego parametru kwalifikuje parametr Name . Wprowadź element nazwy lub wzorzec, taki jak s*. Dozwolone są symbole wieloznaczne.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-InputObject

Określa obiekty ServiceController reprezentujące usługi do pobrania. Wprowadź zmienną zawierającą obiekty lub wpisz polecenie lub wyrażenie, które pobiera obiekty. Do tego polecenia cmdlet można przekazać obiekt usługi.

Typ:ServiceController[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwy usług do pobrania. Dozwolone są symbole wieloznaczne.

Typ:String[]
Aliasy:ServiceName
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-RequiredServices

Wskazuje, że to polecenie cmdlet pobiera tylko usługi wymagane przez tę usługę. Ten parametr pobiera wartość właściwości ServicesDependedOn usługi.

Typ:SwitchParameter
Aliasy:SDO, ServicesDependedOn
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

Dane wejściowe

ServiceController

Do tego polecenia cmdlet można przekazać obiekt usługi.

String

Możesz przekazać nazwę usługi do tego polecenia cmdlet.

Dane wyjściowe

ServiceController

To polecenie cmdlet zwraca obiekty reprezentujące usługi na komputerze.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Get-Service:

  • Windows:
    • gsv

To polecenie cmdlet jest dostępne tylko na platformach windows.

Począwszy od programu PowerShell 6.0, następujące właściwości są dodawane do obiektów ServiceController: UserName, Description, DelayedAutoStart, BinaryPathName i StartupType.

To polecenie cmdlet może wyświetlać usługi tylko wtedy, gdy bieżący użytkownik ma uprawnienia do ich wyświetlania. Jeśli to polecenie cmdlet nie wyświetla usług, być może nie masz uprawnień do ich wyświetlania.

Aby znaleźć nazwę usługi i nazwę wyświetlaną każdej usługi w systemie, wpisz Get-Service. Nazwy usług są wyświetlane w kolumnie Nazwa , a nazwy wyświetlane są w kolumnie DisplayName .

Uwaga

Get-Service Zazwyczaj zwraca informacje o usługach, a nie o sterowniku. Jeśli jednak określisz nazwę sterownika, Get-Service zwraca informacje o sterowniku.

  • Wyliczenie nie obejmuje usług sterowników urządzeń
  • Po określeniu symbolu wieloznakowego polecenie cmdlet zwraca tylko usługi systemu Windows
  • Jeśli określisz nazwę lub nazwę wyświetlaną , która jest dokładnie zgodna z nazwą usługi urządzenia, zwracane jest wystąpienie urządzenia

Podczas sortowania w kolejności rosnącej według wartości Stopped stanu usługi są wyświetlane przed usługami Running . Właściwość Status usługi to wyliczona wartość, w której nazwy stanów reprezentują wartości całkowite. Sortowanie jest oparte na wartości całkowitej, a nie na nazwie. Running jest wyświetlany przed Stopped , ponieważ Stopped ma wartość 1, i Running ma wartość 4. Aby uzyskać więcej informacji, zobacz ServiceControllerStatus.