Partager via


Remove-CimSession

Supprime une ou plusieurs sessions CIM.

Syntaxe

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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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[]
Alias:CN, ServerName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.