Share via

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.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.