Remove-TypeData
Elimina i tipi estesi dalla sessione corrente.
Sintassi
RemoveTypeDataSet (Impostazione predefinita)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Remove-TypeData elimina i dati di tipi estesi dalla sessione corrente. Questo cmdlet influisce solo sulla sessione corrente e sulle sessioni create nella sessione corrente.
È possibile aggiungere proprietà e metodi agli oggetti in PowerShell definendoli nei comandi Update-TypeData e nei file Types.ps1xml.
Remove-TypeData elimina le proprietà estese e i metodi dalla sessione corrente.
Remove-TypeData non elimina i file di Types.ps1xml né elimina le definizioni dei tipi estesi dai file di Types.ps1xml. Per altre informazioni sui file di Types.ps1xml, vedere about_Types.ps1xml.
Questo cmdlet è stato introdotto in Windows PowerShell 3.0.
Esempio
Esempio 1: Rimuovere i dati di tipo per un tipo specificato
In questo esempio vengono eliminati tutti i dati di tipo per il tipo System.Array dalla sessione, inclusi i dati di tipo che provengono da un file Types.ps1xml e i dati di tipo dinamico aggiunti alla sessione usando il cmdlet Update-TypeData.
Remove-TypeData -TypeName System.Array
Esempio 2: Rimuovere un tipo di dati esteso da una sessione
In questo esempio viene illustrato l'effetto della rimozione dei dati di tipo esteso da una sessione. Il primo Get-TypeData riceve dati estesi per il tipo System.DateTime. L'output mostra che una proprietà DateTime è stata aggiunta a tutti gli oggetti System.DateTime in PowerShell. Il cmdlet Get-Date restituisce.
Get-TypeData System.DateTime
(Get-Date).DateTime
Get-TypeData System.DateTime | Remove-TypeData
(Get-Date).DateTime
TypeName Members
-------- -------
System.DateTime {[DateTime, System.Management.Automation.Runspaces.ScriptPropertyData]}
Friday, January 20, 2012 9:01:00 PM
Il cmdlet Get-TypeData successivo per ottenere tutti i dati del tipo esteso per il tipo System.DateTime e i dati vengono inviati tramite pipeline al cmdlet Remove-TypeData per eliminare i dati del tipo esteso. L'ultimo cmdlet Get-Date mostra l'effetto dell'eliminazione dei dati di tipo esteso per il tipo System.DateTime. Poiché la proprietà System.DateTime non esiste più, un comando per ottenere il relativo valore non restituisce nulla.
Esempio 3: Rimuovere i tipi estesi per i moduli
In questo esempio vengono rimossi tutti i dati dei tipi estesi per gli oggetti modulo. Quando si invia tramite pipe un oggetto a Remove-TypeData, Remove-TypeData ottiene il nome del tipo di oggetto e rimuove tutti i dati di tipo per tutti gli oggetti di tale tipo.
Get-Module | Remove-TypeData
Esempio 4: Rimuovere i tipi estesi dai moduli specificati
In questo esempio viene utilizzato il parametro Path del cmdlet Remove-TypeData per rimuovere i tipi estesi definiti nei file Types.ps1xml aggiunti dai moduli PSScheduledJob e PSWorkflow. Questo comando non influisce sui dati di tipo dinamico aggiunti tramite il cmdlet Update-TypeData. Il comando ha esito positivo solo quando i moduli sono stati importati nella sessione corrente.
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
Per altre informazioni sui moduli, vedere about_Modules.
Esempio 5: Rimuovere i tipi estesi da una sessione remota
In questo esempio vengono rimossi i tipi estesi da una sessione remota. Il comando usa il cmdlet Invoke-Command per rimuovere i dati dei tipi estesi per tutti i tipi CIM nelle sessioni nella variabile $S.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Path
Specifica un elenco di file che questo cmdlet elimina dai dati di tipo esteso della sessione. Questo parametro è obbligatorio.
Immettere i percorsi e i nomi di file di uno o più file Types.ps1xml. I caratteri jolly non sono supportati. Se si omette il percorso, la posizione predefinita è la directory corrente.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RemoveFileSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TypeData
Specifica il tipo di dati che questo cmdlet elimina dalla sessione. Questo parametro è obbligatorio. Inserire una variabile che contiene oggetti TypeData (System.Management.Automation.Runspaces.TypeData) o un comando che recupera oggetti TypeData, come un comando Get-TypeData. È anche possibile inviare tramite pipe oggetti TypeData a Remove-TypeData.
Proprietà dei parametri
| Tipo: | TypeData |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RemoveTypeDataSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TypeName
Specifica i tipi per cui questo cmdlet elimina tutti i dati di tipo esteso. Per i tipi nello spazio dei nomi di System, immettere il nome breve. In caso contrario, è necessario il nome completo del tipo. I caratteri jolly non sono supportati.
È possibile inviare tramite pipe i nomi dei tipi a Remove-TypeData. Quando si invia tramite pipe un oggetto a Remove-TypeData, Remove-TypeData ottiene il nome del tipo dell'oggetto e rimuove tutti i dati relativi al tipo dell'oggetto.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
RemoveTypeSet
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
TypeData
È possibile inviare tramite pipe un oggetto TypeData, ad esempio quelli restituiti dal cmdlet Get-TypeData, a questo cmdlet.
String
È possibile inviare tramite pipe una stringa contenente il nome del tipo a questo cmdlet. Quando si invia tramite pipe un oggetto a questo cmdlet, ottiene il nome del tipo dell'oggetto e rimuove tutti i dati di tipo per il tipo di oggetto.
Output
None
Questo cmdlet non restituisce alcun output.
Note
Remove-TypeData, può rimuovere solo i dati di tipo esteso nella sessione corrente. Non è possibile rimuovere dati di tipo estesi presenti nel computer, ma non aggiunti alla sessione corrente, ad esempio i tipi estesi definiti nei moduli che non sono stati importati nella sessione corrente.
