Partager via

Remove-CimSession

Module:
CimCmdlets Module

Supprime une ou plusieurs sessions CIM.

Syntaxe

CimSessionSet (Par défaut) 

Remove-CimSession
    [-CimSession] <CimSession[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerNameSet 

Remove-CimSession
    [-ComputerName] <String[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SessionIdSet 

Remove-CimSession
    [-Id] <UInt32[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstanceIdSet 

Remove-CimSession
    -InstanceId <Guid[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

NameSet 

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.

Propriétés du paramètre

Type:

CimSession[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CimSessionSet
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False
Alias:CN, Nom du serveur

Jeux de paramètres

ComputerNameSet
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

UInt32[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SessionIdSet
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

Guid[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

InstanceIdSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

NameSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.