Remove-CimSession

  • Référence
Module:
CimCmdlets

Supprime une ou plusieurs sessions CIM.

Syntax

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Remove-CimSession de commande supprime un ou plusieurs objets de session CIM de la session PowerShell locale.

Exemples

Exemple 1 : Supprimer toutes les sessions CIM

Cet exemple récupère toutes les sessions CIM disponibles sur l’ordinateur local à l’aide de l’applet de commande Get-CimSession , puis les supprime à l’aide de l’applet Remove-CimSessionde commande .

Get-CimSession | Remove-CimSession

Exemple 2 : Supprimer une session CIM spécifique

Cet exemple montre comment supprimer la session CIM dont la valeur d’ID est 5.

Remove-CimSession -Id 5

Exemple 3 : Afficher la liste des sessions CIM à supprimer à l’aide du paramètre WhatIf

Cet exemple utilise le paramètre commun WhatIf pour spécifier que la suppression ne doit pas être effectuée, mais uniquement la sortie de ce qui se passerait si elle était effectuée.

Remove-CimSession -Name a* -WhatIf

Paramètres

-CimSession

Spécifie les objets de session des sessions CIM à fermer.

Entrez une variable qui contient la session CIM, ou une commande qui crée ou obtient la session CIM, telle que les applets de commande ou Get-CimSession les New-CimSession applets de commande. Pour plus d’informations, consultez about_CimSessions.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Spécifie un tableau de noms d’ordinateurs. Supprime les sessions qui se connectent aux ordinateurs spécifiés. Vous pouvez spécifier un nom de domaine complet (FQDN) ou un nom NetBIOS.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-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

-Id

Spécifie l’ID de la session CIM à supprimer. Spécifiez un ou plusieurs ID séparés par des virgules, ou utilisez l’opérateur de plage (..) pour spécifier une plage d’ID. Un ID est un entier qui identifie de façon unique la session CIM dans la session PowerShell actuelle.

Pour plus d’informations sur l’opérateur de plage, consultez about_Operators.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

Spécifie l’ID d’instance de la session CIM à supprimer. InstanceId est un identificateur global unique (GUID) qui identifie de manière unique une session CIM. InstanceId est unique, même lorsque vous avez plusieurs sessions en cours d’exécution dans PowerShell.

InstanceId est stocké dans la propriété InstanceId de l’objet qui représente une session CIM.

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

-Name

Spécifie le nom convivial de la session CIM à supprimer. Vous pouvez utiliser des caractères génériques carte avec ce paramètre.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-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

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

Object

Cette applet de commande retourne un objet qui contient des informations de session CIM.

Notes

PowerShell inclut les alias suivants pour Remove-CimSession:

  • Windows :
    • rcms

Cette applet de commande est disponible uniquement sur les plateformes Windows.