lundi 21 novembre 2011

Get-Service

NOM
    Get-Service

RÉSUMÉ
    Obtient les services présents sur un ordinateur local ou distant.

SYNTAXE
    Get-Service [[-Name] <string[]>] [-ComputerName <string[]>] [-DependentServices] [-Exclude <string[]>] [-Include <string[]>] [-RequiredServices] [<CommonParameters>]

    Get-Service -DisplayName <string[]> [-ComputerName <string[]>] [-DependentServices] [-Exclude <string[]>] [-Include <string[]>] [-RequiredServices] [<CommonParameters>]

    Get-Service [-InputObject <ServiceController[]>] [-ComputerName <string[]>] [-DependentServices] [-Exclude <string[]>] [-Include <string[]>] [-RequiredServices] [<CommonParameters>]


DESCRIPTION
    L'applet de commande Get-Service obtient les objets qui représentent les services présents sur un ordinateur local ou un ordinateur distant, y compris les services en cours d'exécution et les services arrêtés.

    Vous pouvez diriger Get-Service de manière à obtenir uniquement des services particuliers en spécifiant le nom ou le nom d'affichage de ces services ou vous pouvez diriger des objets service vers Get-Service.


PARAMÈTRES
    -ComputerName <string[]>
        Obtient les services qui s'exécutent sur les ordinateurs spécifiés. La valeur par défaut est l'ordinateur local.

        Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) ou « localhost ».

        Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName de Get-Service même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut                     Localhost
        Accepter l'entrée de pipeline ?       true (ByPropertyName)
        Accepter les caractères génériques ?  false

    -DependentServices [<SwitchParameter>]
        Obtient uniquement les services qui dépendent du service spécifié.

        Par défaut, Get-Service obtient tous les services.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut                     False
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -DisplayName <string[]>
        Spécifie les noms d'affichage des services à récupérer. Les caractères génériques sont autorisés. Par défaut, Get-Service obtient tous les services présents sur l'ordinateur.

        Obligatoire ?                true
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Exclude <string[]>
        Omet les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -Include <string[]>
        Récupère uniquement les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -InputObject <ServiceController[]>
        Spécifie les objets ServiceController représentant les services à récupérer. Entrez une variable contenant les objets, ou tapez une commande ou une expression permettant d'obtenir ces objets. Vous pouvez également diriger un objet service vers Get-Service.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut
        Accepter l'entrée de pipeline ?       true (ByValue)
        Accepter les caractères génériques ?  false

    -Name <string[]>
        Spécifie les noms des services à récupérer. Les caractères génériques sont autorisés. Par défaut, Get-Service obtient tous les services présents sur l'ordinateur.

        Obligatoire ?                false
        Position ?                   1
        Valeur par défaut
        Accepter l'entrée de pipeline ?       true (ByValue, ByPropertyName)
        Accepter les caractères génériques ?  true

    -RequiredServices [<SwitchParameter>]
        Obtient uniquement les services que ce service requiert.

        Ce paramètre obtient la valeur de la propriété ServicesDependedOn du service. Par défaut, Get-Service obtient tous les services.

        Obligatoire ?                false
        Position ?                   named
        Valeur par défaut                     False
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

ENTRÉES
    System.ServiceProcess.ServiceController, System.String
        Vous pouvez diriger un objet service ou un nom de service vers Get-Service.


SORTIES
    System.ServiceProcess.ServiceController
        Get-Service retourne des objets qui représentent les services sur l'ordinateur.


NOTES


        Vous pouvez également faire référence à Get-Service par son alias intégré, « gsv ». Pour plus d'informations, consultez about_Aliases.

        Pour que Get-Service soit en mesure d'afficher les services, l'utilisateur actuel doit être autorisé à les afficher. Si Get-Service n'affiche pas les services, cela signifie peut-être que vous n'êtes pas autorisé à le faire.

        Pour rechercher les noms de services et les noms d'affichage des services sur votre système, tapez « get-service ». Les noms de services figurent dans la colonne Name et les noms d'affichage apparaissent dans la colonne DisplayName.

        Lorsque vous procédez à un tri dans l'ordre croissant en fonction de la valeur d'état, les services arrêtés (Stopped) apparaissent avant les services en cours d'exécution (Running). La propriété Status d'un service est une valeur énumérée dans laquelle le nom des états représente des valeurs entières. Le tri repose sur la valeur entière, et non sur le nom. « Running » apparaît avant « Stopped », car « Stopped » a la valeur « 1 » et « Running » a la valeur « 4 ».


    -------------------------- EXEMPLE 1 --------------------------

    C:\PS>get-service


    Description
    -----------
    Cette commande récupère tous les services sur le système. Elle s'exécute comme si vous aviez tapé « get-service * ». L'affichage par défaut répertorie l'état, le nom et le nom d'affichage de chaque service.





    -------------------------- EXEMPLE 2 --------------------------

    C:\PS>get-service wmi*


    Description
    -----------
    Cette commande récupère des services dont les noms commencent par « WMI » (acronyme pour Windows Management Instrumentation).





    -------------------------- EXEMPLE 3 --------------------------

    C:\PS>get-service -displayname *network*


    Description
    -----------
    Cette commande affiche les services dont le nom d'affichage inclut le mot
    « network ». La recherche du nom d'affichage permet de rechercher des services associés au réseau, y compris lorsque leur nom n'inclut pas le mot « Net » (xmlprov, le service d'approvisionnement réseau, par exemple).





    -------------------------- EXEMPLE 4 --------------------------

    C:\PS>get-service -name win* -exclude winrm


    Description
    -----------
    Ces commandes obtiennent uniquement les services dont le nom de service commence par « win », à l'exception du service WinRM.





    -------------------------- EXEMPLE 5 --------------------------

    C:\PS>get-service | where-object {$_.Status -eq "Running"}


    Description
    -----------
    Cette commande affiche uniquement les services actuellement en cours d'exécution. Elle utilise l'applet de commande Get-Service pour obtenir tous les services présents sur l'ordinateur. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object qui sélectionne uniquement les services dont la propriété Status a la valeur « Running ».

    Status n'est qu'une des propriétés des objets Service. Pour voir toutes les propriétés, tapez « get-service | get-member »:





    -------------------------- EXEMPLE 6 --------------------------

    C:\PS>get-service -computername Server02


    Description
    -----------
    Cette commande obtient les services présents sur l'ordinateur distant Server02.

    Comme le paramètre ComputerName de Get-Service n'utilise pas la communication à distance Windows PowerShell, vous pouvez utiliser ce paramètre même si l'ordinateur n'est pas configuré pour la communication à distance dans Windows PowerShell.





    -------------------------- EXEMPLE 7 --------------------------

    C:\PS>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
    ...


    Description
    -----------
    Ces commandes répertorient les services présents sur l'ordinateur qui possèdent des services dépendants.

    La première commande utilise l'applet de commande Get-Service pour obtenir les services présents sur l'ordinateur.
    Un opérateur de pipeline (|) envoie les services à l'applet de commande Where-Object, qui sélectionne les services dont la propriété DependentServices n'a pas la valeur null.

    Un autre opérateur de pipeline envoie les résultats à l'applet de commande Format-List. La commande utilise son paramètre Property pour afficher le nom du service, le nom des services dépendants, ainsi qu'une propriété calculée qui indique le nombre de services dépendants appartenant à chaque service.





    -------------------------- EXEMPLE 8 --------------------------

    C:\PS>C:\PS> 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

    C:\PS> get-service s* | sort-object status -descending

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


    Description
    -----------
    Cette commande montre que lorsque vous triez des services dans l'ordre croissant en fonction de la valeur de leur p
    ropriété Status, les services arrêtés (Stopped) apparaissent avant les services en cours d'exécution (Running). Cela est dû au fait que la valeur de Status est une énumération, dans laquelle « Stopped » a la valeur « 1 » et « Running » a la valeur « 4 ».

    Pour répertorier les services en cours d'exécution en premier, utilisez le paramètre Descending de l'applet de commande Sort-Object.





    -------------------------- EXEMPLE 9 --------------------------

    C:\PS>get-service -name winrm -computername localhost, Server01, Server02  | format-table -property MachineName, Status, Name, DisplayName -auto

    MachineName    Status  Name  DisplayName
    ------------   ------  ----  -----------
    localhost      Running WinRM Windows Remote Management (WS-Management)
    Server01       Running WinRM Windows Remote Management (WS-Management)
    Server02       Running WinRM Windows Remote Management (WS-Management)


    Description
    -----------
    Cette commande utilise l'applet de commande Get-Service pour exécuter une commande « Get-Service Winrm » sur deux ordinateurs distants et l'ordinateur local (« localhost »).

    La commande Get-Service s'exécute sur les ordinateurs distants et les résultats sont retournés à l'ordinateur local. Un opérateur de pipeline (|) envoie les résultats à l'applet de commande Format-Table, qui présente les services sous forme de tableau. La commande Format-Table utilise le paramètre Property pour spécifier les propriétés affichées dans le tableau, notamment la propriété MachineName.





    -------------------------- EXEMPLE 10 --------------------------

    C:\PS>get-service winrm -requiredServices


    Description
    -----------
    Cette commande obtient les services requis par le service WinRM.

    La commande retourne la valeur de la nouvelle propriété ServicesDependedOn du service.





    -------------------------- EXEMPLE 11 --------------------------

    C:\PS>"winrm" | get-service


    Description
    -----------
    Cette commande obtient le service WinRM présent sur l'ordinateur local. Cet exemple montre que vous pouvez diriger une chaîne de nom de service (placée entre guillemets) vers Get-Service.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=113332
    Start-Service
    Stop-Service
    Restart-Service
    Resume-Service
    Suspend-Service
    Set-Service
    New-Service

Aucun commentaire:

Enregistrer un commentaire