Update-FormatData
Atualiza os dados de formatação na sessão atual.
Sintaxe
Default (Default)
Update-FormatData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Update-FormatData recarrega os dados de formatação de arquivos de formatação para a sessão atual. Esse cmdlet permite que você atualize os dados de formatação sem reiniciar o Windows PowerShell.
Sem parâmetros, Update-FormatData recarrega os arquivos de formatação carregados anteriormente. Você pode usar os parâmetros de Update-FormatData para adicionar novos arquivos de formatação à sessão.
Os arquivos de formatação são arquivos de texto no formato XML com a extensão de nome de arquivo format.ps1xml. Os dados de formatação nos arquivos definem a exibição de objetos do Microsoft .NET Framework na sessão.
Quando o Windows PowerShell é iniciado, ele carrega os dados de formato dos arquivos de formatação no diretório de instalação do Windows PowerShell ($pshome) na sessão. Você pode usar Update-FormatData para recarregar os dados de formatação na sessão atual sem reiniciar o Windows PowerShell. Isso é útil quando você adicionou ou alterou um arquivo de formatação, mas não deseja interromper a sessão.
Para obter mais informações sobre a formatação de arquivos no Windows PowerShell, consulte about_Format.ps1xml.
Exemplos
Exemplo 1: recarregar arquivos de formatação carregados anteriormente
PS C:\> Update-FormatData
Esse comando recarrega os arquivos de formatação que ele carregou anteriormente.
Exemplo 2: recarregar arquivos de formatação e arquivos de formatação de rastreamento e log
PS C:\> Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"
Esse comando recarrega os arquivos de formatação na sessão, incluindo dois novos arquivos, Trace.format.ps1xml e Log.format.ps1xml.
Como o comando usa o parâmetro AppendPath, os dados de formatação nos novos arquivos são carregados após os dados de formatação dos arquivos internos.
O parâmetro AppendPath é usado porque os novos arquivos contêm dados de formatação para objetos que não são referenciados nos arquivos internos.
Exemplo 3: Editar um arquivo de formatação e recarregá-lo
PS C:\> Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"
# Edit the NewFiles.format.ps1 file.
PS C:\> Update-FormatData
Este exemplo mostra como recarregar um arquivo de formatação depois de editá-lo.
O primeiro comando adiciona o arquivo NewFiles.format.ps1xml à sessão. Ele usa o parâmetro PrependPath porque o arquivo contém dados de formatação para objetos referenciados nos arquivos internos.
Depois de adicionar o arquivo NewFiles.format.ps1xml e testá-lo nessas sessões, o autor edita o arquivo.
O segundo comando usa o cmdlet
Parâmetros
-AppendPath
Especifica arquivos de formatação que esse cmdlet adiciona à sessão. Os arquivos são carregados depois que o Windows PowerShell carrega os arquivos de formatação internos.
Ao formatar objetos .NET, o Windows PowerShell usa a primeira definição de formatação encontrada para cada tipo .NET. Se você usar o parâmetro AppendPath, o Windows PowerShell pesquisará os dados dos arquivos internos antes de encontrar os dados de formatação que você está adicionando.
Use esse parâmetro para adicionar um arquivo que formate um objeto .NET que não é referenciado nos arquivos de formatação internos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath, Caminho |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-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 |
-PrependPath
Especifica arquivos de formatação que esse cmdlet adiciona à sessão. Os arquivos são carregados antes que o Windows PowerShell carregue os arquivos de formatação internos.
Ao formatar objetos .NET, o Windows PowerShell usa a primeira definição de formatação encontrada para cada tipo .NET. Se você usar o parâmetro PrependPath, o Windows PowerShell pesquisará os dados dos arquivos que você está adicionando antes de encontrar os dados de formatação dos arquivos internos.
Use esse parâmetro para adicionar um arquivo que formate um objeto .NET que também é referenciado nos arquivos de formatação internos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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
String
Você pode canalizar uma cadeia de caracteres que contém o caminho de acréscimo para Update-FormatData.
Saídas
None
O cmdlet não retorna nenhuma saída.
Observações
Update-FormatData também atualiza os dados de formatação para comandos na sessão que foram importados de módulos. Se o arquivo de formatação de um módulo for alterado, você poderá executar um comando Update-FormatData para atualizar os dados de formatação para comandos importados. Você não precisa importar o módulo novamente.