Partager via

Remove-SCService

  • Référence
Module:
VirtualMachineManager

Supprime un service VMM et toutes les machines virtuelles associées.

Syntax

Remove-SCService
      [-VMMServer <ServerConnection>]
      [-Service] <Service>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

L’applet de commande Remove-SCService supprime un service Virtual Machine Manager (VMM) et toutes les machines virtuelles associées de l’hôte sur lequel elle est déployée. Le service doit être dans un état arrêté avant de le supprimer. Pour arrêter un service, utilisez l’applet de commande Stop-SCService.

Exemples

Exemple 1 : Supprimer un service spécifique déployé sur un hôte

PS C:\> $Service = Get-SCService -VMMServer "VMMServer01.Contoso.com" -Name "Service01"
PS C:\> Stop-SCService -Service $Service
PS C:\> Remove-SCService -Service $Service -Confirm

La première commande obtient l’objet de service nommé Service01 sur VMMServer01 et stocke l’objet dans la variable $Service.

La deuxième commande arrête le service stocké dans $Service.

La dernière commande supprime le service stocké dans $Service et supprime les fichiers de machine virtuelle correspondants du système de fichiers. Une invite de confirmation s’affiche avant la suppression du service.

Exemple 2 : Supprimer tous les services avec des noms qui incluent une chaîne spécifique

PS C:\> $Services = Get-SCService -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "Service" }
PS C:\> $Services | Stop-SCService
PS C:\> $Services | Remove-SCService -Confirm

La première commande obtient tous les objets de service qui incluent la chaîne « Service » dans leur nom, puis stocke les objets dans la variable $Services.

La deuxième commande arrête tous les services stockés dans $Service.

La troisième commande supprime tous les objets de service contenus dans $Services et supprime les fichiers de machine virtuelle correspondants du système de fichiers. Une invite de confirmation s’affiche avant la suppression du service.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur spécifié par ce paramètre.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

Spécifie un objet de service VMM.

Type:Service
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False