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 de commande Remove-CimSession 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 la .

Get-CimSession | Remove-CimSession

Exemple 2 : Supprimer une session CIM spécifique

Cet exemple montre comment supprimer la session CIM qui a une valeur ID 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 New-CimSession ou Get-CimSession. 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 invite à confirmer 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 manière 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. L' InstanceId est unique, même lorsque vous avez plusieurs sessions en cours d’exécution dans PowerShell.

Le 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

Affiche ce qui se passerait si l’applet de commande s’exécute. 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

Cette applet de commande n’accepte aucun objet d’entrée.

Sorties

Object

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