Partilhar via


Wide View (Basic) (Vista 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 vista alargada, consulte Criando uma vista alargada.

Carregue este ficheiro de formatação

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

  2. Guarde o ficheiro de texto. Certifique-se de adicionar a extensão format.ps1xml ao arquivo para identificá-lo 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>.

    Advertência

    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 ficheiro de formatação demonstra os seguintes elementos XML:

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

  • O ViewSelectedBy elemento que define quais objetos são exibidos pelo modo de exibição.

  • O WideItem elemento 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 o 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

Ver também

exemplos de formatação de arquivos

Escrevendo um arquivo de formatação do PowerShell