Remove-TypeData
Exclui tipos estendidos da sessão atual.
Sintaxe
RemoveTypeDataSet (Padrão)
Remove-TypeData
-TypeData <TypeData>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveTypeSet
Remove-TypeData
[-TypeName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveFileSet
Remove-TypeData
-Path <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-TypeData exclui dados de tipo estendido da sessão atual. Esse cmdlet afeta apenas a sessão e as sessões atuais que são criadas na sessão atual.
Você pode adicionar propriedades e métodos a objetos no PowerShell definindo-os em comandos Update-TypeData e arquivos Types.ps1xml.
Remove-TypeData exclui essas propriedades e métodos estendidos da sessão atual.
Remove-TypeData não exclui os arquivos Types.ps1xml nem exclui definições de tipo estendido dos arquivos de Types.ps1xml. Para obter mais informações sobre arquivos Types.ps1xml, consulte about_Types.ps1xml.
Esse cmdlet foi introduzido no Windows PowerShell 3.0.
Exemplos
Exemplo 1: remover dados de tipo para um tipo especificado
Este exemplo exclui todos os dados de tipo para o tipo System.Array da sessão, incluindo dados de tipo que foram adicionados por um arquivo Types.ps1xml e dados de tipo dinâmico que foram adicionados à sessão usando o cmdlet Update-TypeData.
Remove-TypeData -TypeName System.Array
Exemplo 2: remover um tipo de dados estendido de uma sessão
Este exemplo mostra o efeito da remoção de dados de tipo estendido de uma sessão. O primeiro Get-TypeData obtém dados de tipo estendidos para o tipo System.DateTime. A saída mostra que uma propriedade DateTime foi adicionada a todos os objetos System.DateTime no PowerShell. O cmdlet Get-Date retorna um objeto System.DateTime. O comando usa notação de ponto para obter o valor da propriedade DateTime do objeto System.DateTime que Get-Date retorna.
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
O próximo Get-TypeData cmdlet para obter todos os dados de tipo estendido para o tipo de System.DateTime e pipes que para o cmdlet Remove-TypeData para excluir os dados de tipo estendido. O último cmdlet Get-Date mostra o efeito da exclusão dos dados de tipo estendido para o tipo de System.DateTime. Como a propriedade System.DateTime não existe mais, um comando para obter seu valor não retorna nada.
Exemplo 3: remover tipos estendidos para módulos
Este exemplo remove todos os dados de tipo estendido para objetos de módulo. Quando você redireciona um objeto para Remove-TypeData, Remove-TypeData obtém o nome do tipo de objeto e remove todos os dados de tipo para todos os objetos desse tipo.
Get-Module | Remove-TypeData
Exemplo 4: remover tipos estendidos de módulos especificados
Este exemplo usa o parâmetro caminho do cmdlet Remove-TypeData para remover os tipos estendidos definidos nos arquivos Types.ps1xml adicionados pelos módulos PSScheduledJob e PSWorkflow. Esse comando não afeta os dados de tipo dinâmico adicionados usando o cmdlet Update-TypeData. O comando é bem-sucedido somente quando os módulos foram importados para a sessão atual.
Remove-TypeData -Path "$PSHOME\Modules\PSScheduledJob", "$PSHOME\Modules\PSWorkflow\PSWorkflow.types.ps1xml"
Para obter mais informações sobre módulos, consulte about_Modules.
Exemplo 5: remover tipos estendidos de uma sessão remota
Este exemplo remove tipos estendidos de uma sessão remota. O comando usa o cmdlet Invoke-Command para remover dados de tipo estendido para todos os tipos de CIM nas sessões na variável $S.
Invoke-Command -Session $S {Get-TypeData -TypeName *CIM* | Remove-TypeData}
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Path
Especifica uma matriz de arquivos que esse cmdlet exclui dos dados de tipo estendido da sessão. Este parâmetro é obrigatório.
Insira os caminhos e os nomes de arquivo de um ou mais arquivos Types.ps1xml. Não há suporte para curingas. Se você omitir o caminho, o local padrão será o diretório atual.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RemoveFileSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TypeData
Especifica os dados de tipo que esse cmdlet exclui da sessão. Este parâmetro é obrigatório. Insira uma variável que contenha objetos typeData (System.Management.Automation.Runspaces.TypeData) ou um comando que obtém objetos TypeData, como um comando Get-TypeData. Você também pode redirecionar objetos TypeData para Remove-TypeData.
Propriedades do parâmetro
| Tipo: | TypeData |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RemoveTypeDataSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TypeName
Especifica os tipos para os quais esse cmdlet exclui todos os dados de tipo estendido. Para tipos no namespace do sistema, insira o nome curto. Caso contrário, o nome de tipo completo será necessário. Não há suporte para curingas.
Você pode canalizar nomes de tipo para Remove-TypeData. Quando você redireciona um objeto para Remove-TypeData, Remove-TypeData obtém o nome do tipo do objeto e remove todos os dados de tipo para o tipo de objeto.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
RemoveTypeSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
TypeData
Você pode canalizar um objeto TypeData, como os que o cmdlet Get-TypeData retorna, para este cmdlet.
String
Você pode canalizar uma cadeia de caracteres que contém o nome do tipo para este cmdlet. Quando você redireciona um objeto para esse cmdlet, ele obtém o nome do tipo do objeto e remove todos os dados de tipo para o tipo de objeto.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
Remove-TypeData pode remover apenas os dados de tipo estendido na sessão atual. Ele não pode remover dados de tipo estendido que estão no computador, mas não foram adicionados à sessão atual, como tipos estendidos definidos em módulos que não foram importados para a sessão atual.
