Update-FormatData

Artigo
10/30/2009

Atualiza os dados de formatação na sessão atual.

Sintaxe

Update-FormatData [[-AppendPath] <string[]>] [-PrependPath <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

O cmdlet Update-FormatData recarrega os dados de formatação de arquivos de formatação na sessão atual. Esse cmdlet permite atualizar os dados de formatação sem reiniciar o Windows PowerShell.

Sem parâmetros, Update-FormatData recarrega os arquivos de formatação previamente carregados. Você pode usar os parâmetros de Update-FormatData para acrescentar 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 inicia, ele carrega os dados de formato dos arquivos de formatação do 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ê tiver adicionado ou alterado um arquivo de formatação, mas não deseja interromper a sessão.

Para obter mais informações sobre arquivos de formatação no Windows PowerShell, consulte about_Format.ps1xml.

Parâmetros

-AppendPath <string[]>

Acrescenta os arquivos de formatação especificados à 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 que encontra 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 formata um objeto .NET que não é referenciado nos arquivos de formatação internos.

Necessário?	false
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	true (ByValue, ByPropertyName)
Aceitar caracteres curinga?	false

-PrependPath <string[]>

Acrescenta os arquivos de formatação especificados à sessão. Os arquivos são carregados antes de o Windows PowerShell carregar os arquivos de formatação internos.

Ao formatar objetos .NET, o Windows PowerShell usa a primeira definição de formatação que encontra 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 formata um objeto .NET que também é referenciado nos arquivos de formatação internos.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

Você pode canalizar uma cadeia de caracteres que contém o caminho de acréscimo para Update-FormatData.

Saídas

Nenhum

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 para 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.

Exemplo 1

C:\PS>update-formatdata

Descrição
-----------
Esse comando recarrega os arquivos de formatação previamente carregados.

Exemplo 2

C:\PS>update-formatdata -appendpath trace.format.ps1xml, log.format.ps1xml

Descrição
-----------
Esse comando recarrega os arquivos de formatação na sessão, inclusive dois novos arquivos, Trace.format.ps1xml e Log.format.ps1xml. 

Como o comando usa o parâmetro AppendPath, os dados de formatação dos arquivos novos são carregados depois dos 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

C:\PS>update-formatdata -prependPath c:\test\NewFiles.format.ps1xml

# Edit the NewFiles.format.ps1 file.

C:\PS> update-formatdata

Descrição
-----------
Esse exemplo mostra como recarregar um arquivo de formatação depois de tê-lo editado.

O primeiro comando acrescenta o arquivo NewFiles.format.ps1xml à sessão. Ele usa o parâmetro PrependPath porque o arquivo contém dados de formatação para objetos que são referenciados nos arquivos internos.

Depois de adicionar o arquivo NewFiles.format.ps1xml e testá-lo nessa sessão, o autor edita o arquivo.

O segundo comando usa o cmdlet Update-FormatData para recarregar os arquivos de formatação. Como o arquivo NewFiles.format.ps1xml foi previamente carregado, Update-FormatData irá recarregá-lo automaticamente sem usar parâmetros.

Compartilhar via