Compartilhar via


Exibição ampla (Básica)

Este exemplo mostra como implementar uma exibição ampla básica que exibe os objetos System.ServiceProcess.ServiceController retornados pelo cmdlet Get-Service. Para obter mais informações sobre os componentes de uma exibição ampla, consulte Criando umde Exibição Ampla.

Carregar este arquivo de formatação

  1. Copie o XML da seção Exemplo deste tópico em um arquivo de texto.

  2. Salve o arquivo de texto. Adicione a extensão format.ps1xml ao arquivo para identificá-la como um arquivo de formatação.

  3. Abra o Windows PowerShell e execute o seguinte comando para carregar o arquivo de formatação na sessão atual: Update-FormatData -PrependPath <PathToFormattingFile>.

    Aviso

    Esse arquivo de formatação define a exibição de um objeto que já está definido por um arquivo de formatação do Windows PowerShell. Você deve usar o parâmetro PrependPath ao executar o cmdlet e não pode carregar esse arquivo de formatação como um módulo.

Demonstra

Este arquivo de formatação demonstra os seguintes elementos XML:

  • O elemento Name para o modo de exibição.

  • O elemento ViewSelectedBy que define quais objetos são exibidos pela exibição.

  • O elemento WideItem que define qual propriedade é exibida pelo modo de exibição.

Exemplo

O XML a seguir define uma exibição ampla que exibe o valor da propriedade System.ServiceProcess.ServiceController.ServiceName.

<?xml version="1.0" encoding="utf-8" ?>

<Configuration>
  <ViewDefinitions>
    <View>
      <Name>ServiceWideView</Name>
      <ViewSelectedBy>
        <TypeName>System.ServiceProcess.ServiceController</TypeName>
      </ViewSelectedBy>
      <WideControl>
        <WideEntries>
          <WideEntry>
            <WideItem>
              <PropertyName>ServiceName</PropertyName>
            </WideItem>
          </WideEntry>
        </WideEntries>
      </WideControl>
    </View>
  </ViewDefinitions>
</Configuration>

O exemplo a seguir mostra como o Windows PowerShell exibe os objetos System.ServiceProcess.ServiceController depois que esse arquivo de formato é carregado.

Get-Service f*
Fax                      FCSAM
fdPHost                  FDResPub
FontCache                FontCache3.0.0.0
FSysAgent                FwcAgent

Consulte Também

exemplos de arquivos de formatação

Criando um arquivo de formatação do PowerShell