Update-FormatData
Atualiza os dados de formatação na sessão atual.
Syntax
Update-FormatData
[[-AppendPath] <String[]>]
[-PrependPath <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O Update-FormatData cmdlet recarrega os dados de formatação da formatação de arquivos na sessão atual. Esse cmdlet permite atualizar os dados de formatação sem reiniciar o PowerShell.
Sem parâmetros, Update-FormatData recarrega os arquivos de formatação que ele carregou anteriormente.
Você pode usar os parâmetros para Update-FormatData 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 format.ps1xml arquivo. A formatação de dados nos arquivos define a exibição de objetos do Microsoft .NET Framework presentes na sessão.
Quando o PowerShell é iniciado, ele carrega os dados de formato do código-fonte do PowerShell. No entanto, você pode criar arquivos format.ps1xml personalizados para atualizar a formatação na sessão atual. Você pode usar Update-FormatData para recarregar os dados de formatação na sessão atual sem reiniciar o PowerShell. Isso é útil para quando você adicionou ou alterou um arquivo de formatação, mas não deseja interromper a sessão.
Para obter mais informações sobre como formatar arquivos no PowerShell, consulte about_Format.ps1xml.
Exemplos
Exemplo 1: recarregar arquivos de formatação carregados anteriormente
Update-FormatDataEste comando recarrega os arquivos de formatação que havia carregado anteriormente.
Exemplo 2: Recarregar arquivos de formatação e arquivos de formatação de rastreamento e log
Update-FormatData -AppendPath "trace.format.ps1xml, log.format.ps1xml"Este comando recarrega os arquivos de formatação para a 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 a formatação de dados 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
Update-FormatData -PrependPath "c:\test\NewFiles.format.ps1xml"
# Edit the NewFiles.format.ps1 file.
Update-FormatDataEste exemplo mostra como recarregar um arquivo formatação após você tê-lo editado.
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 Update-FormatData cmdlet para recarregar os arquivos de formatação. Como o arquivo NewFiles.format.ps1xml foi carregado anteriormente, Update-FormatData recarrega-o automaticamente sem usar parâmetros.
Parâmetros
-AppendPath
Especifica arquivos de formatação que esse cmdlet adiciona à sessão. Os arquivos são carregados depois que o PowerShell carrega os arquivos de formatação internos.
Ao formatar objetos .NET, o PowerShell usa a primeira definição de formatação encontrada para cada tipo .NET. Se você usar o parâmetro AppendPath , o PowerShell pesquisará os dados dos arquivos internos antes de encontrar os dados de formatação que você está adicionando.
Use este parâmetro para adicionar um arquivo que formata um objeto .NET que não é referenciado nos arquivos de formatação internos.
| Type: | String[] |
| Aliases: | PSPath, Path |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrependPath
Especifica arquivos de formatação que esse cmdlet adiciona à sessão. Os arquivos são carregados antes que o PowerShell carregue os arquivos de formatação internos.
Ao formatar objetos .NET, o PowerShell usa a primeira definição de formatação encontrada para cada tipo .NET. Se você usar o parâmetro PrependPath , o PowerShell pesquisará os dados dos arquivos que você está adicionando antes de encontrar os dados de formatação dos arquivos internos.
Use este parâmetro para adicionar um arquivo que formata um objeto .NET que também é referenciado nos arquivos de formatação internos.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
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-FormatDatatambé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 umUpdate-FormatDatacomando para atualizar os dados de formatação para comandos importados. Você não precisa importar o módulo novamente.