Partager via


Remove-CimSession

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

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

Get-CimSession | Remove-CimSession

Cette commande 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'.

Exemple 2 : Supprimer une session CIM spécifique

Remove-CimSession -Id 5

Cette commande supprime la session CIM dont la valeur d’ID est 5.

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

Remove-CimSession -Name a* -WhatIf

Cette commande 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.

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 le nom de l’ordinateur pour connecter les sessions CIM. Les caractères génériques sont autorisés.

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. Il est plus facile de mémoriser et de taper que InstanceId, mais il est unique uniquement 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. InstanceId est unique, même lorsque vous avez plusieurs sessions en cours d’exécution dans PowerShell.

L’Id d’instance 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

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.