Condividi tramite

Remove-CimSession

  • Riferimento
Modulo:
CimCmdlets

Rimuove una o più sessioni CIM.

Sintassi

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>]

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Il Remove-CimSession cmdlet rimuove uno o più oggetti sessione CIM dalla sessione di PowerShell locale.

Esempio

Esempio 1: Rimuovere tutte le sessioni CIM

In questo esempio vengono recuperate tutte le sessioni CIM disponibili nel computer locale usando il cmdlet Get-CimSession e quindi le rimuove usando .Remove-CimSession

Get-CimSession | Remove-CimSession

Esempio 2: Rimuovere una sessione CIM specifica

In questo esempio viene rimossa la sessione CIM con valore ID pari a 5.

Remove-CimSession -Id 5

Esempio 3: Visualizzare l'elenco delle sessioni CIM da rimuovere usando il parametro WhatIf

In questo esempio viene usato il parametro comune WhatIf per specificare che la rimozione non deve essere eseguita, ma restituisce solo ciò che accadrebbe se fosse stato fatto.

Remove-CimSession -Name a* -WhatIf

Parametri

-CimSession

Specifica gli oggetti sessione delle sessioni CIM da chiudere.

Immettere una variabile contenente la sessione CIM o un comando che crea o ottiene la sessione CIM, ad esempio i New-CimSession cmdlet o Get-CimSession . Per altre informazioni, vedere about_CimSessions.

Tipo:CimSession[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ComputerName

Specifica una matrice di nomi di computer. Rimuove le sessioni che si connettono ai computer specificati. È possibile specificare un nome di dominio completo (FQDN) o un nome NetBIOS.

Tipo:String[]
Alias:CN, ServerName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica l'ID della sessione CIM da rimuovere. Specificare uno o più ID separati da virgole oppure usare l'operatore range (..) per specificare un intervallo di ID. Un ID è un numero intero che identifica in modo univoco la sessione CIM nella sessione di PowerShell corrente.

Per altre informazioni sull'operatore range, vedere about_Operators.

Tipo:UInt32[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InstanceId

Specifica l'ID istanza della sessione CIM da rimuovere. InstanceId è un IDENTIFICATORe univoco globale (GUID) che identifica in modo univoco una sessione CIM. InstanceId è univoco, anche quando sono in esecuzione più sessioni in PowerShell.

InstanceId viene archiviato nella proprietà InstanceId dell'oggetto che rappresenta una sessione CIM.

Tipo:Guid[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome descrittivo della sessione CIM da rimuovere. È possibile usare caratteri jolly con questo parametro.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

Object

Questo cmdlet restituisce un oggetto che contiene informazioni sulla sessione CIM.

Note

PowerShell include gli alias seguenti per Remove-CimSession:

  • Windows:
    • rcms

Questo cmdlet è disponibile solo nelle piattaforme Windows.