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

Il cmdlet Remove-CimSession 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 il .

Get-CimSession | Remove-CimSession

Esempio 2: Rimuovere una sessione CIM specifica

In questo esempio viene rimossa la sessione CIM con un Id di il cui valore è 5.

Remove-CimSession -Id 5

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

Questo esempio usa 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 cmdlet New-CimSession 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 di intervallo (..) 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 ulteriori informazioni sull'operatore di intervallo, consultare 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 dell'istanza della sessione CIM da rimuovere. InstanceId è un identificatore univoco globale (GUID) che identifica in modo univoco una sessione CIM. L'istanza InstanceId è univoca, anche quando sono in esecuzione più sessioni in PowerShell.

Il 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 cosa accadrebbe se il cmdlet viene eseguito. 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.