about_Path_Syntax

Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0

TÓPICO

about_Path_Syntax

DESCRIÇÃO BREVE

Descreve os formatos de nome de caminho completo e relativo em Windows PowerShell.

DESCRIÇÃO LONGA

Todos os itens em um armazenamento de dados acessível por meio de um provedor Windows PowerShell podem ser identificados exclusivamente por seus nomes de caminho. Um nome de caminho é uma combinação do nome do item, o contêiner e os subcontêineres nos quais o item está localizado, e o drive Windows PowerShell por meio do qual os contêineres são acessados.

Em Windows PowerShell, nomes de caminho são divididos em um destes dois tipos: totalmente qualificado e relativo. Um nome de caminho totalmente qualificado consiste em todos os elementos que compõem um caminho. A sintaxe a seguir mostra os elementos em um nome de caminho totalmente qualificado:

        [<provider>::]<drive>:[\<container>[\<subcontainer>...]]\<item>

O espaço reservado <provider> refere-se ao provedor Windows PowerShell usado para acessar o armazenamento de dados. Por exemplo, o provedor do FileSystem permite que você acesse os arquivos e diretórios em seu computador. Esse elemento da sintaxe é opcional e nunca é necessário porque os nomes de unidade são exclusivos em todos os provedores.

O espaço reservado <drive> refere-se para a unidade Windows PowerShell é suportada por um determinado provedor Windows PowerShell. No caso do provedor do FileSystem, as unidades Windows PowerShell são mapeadas para as unidades do Windows que estão configuradas no seu sistema. Por exemplo, se seu sistema inclui um A: unidade de disco e uma unidade de disco C: , o provedor FileSystem cria as mesmas unidades em Windows PowerShell.

Depois de especificar a unidade, você deve especificar todos os contêineres e subcontêineres que contêm o item. Os contêineres devem ser especificados na ordem hierárquica em que existem no armazenamento de dados. Em outras palavras, você deve começar com o contêiner pai, em seguida, o contêiner filho no contêiner pai e assim por diante. Além disso, cada contêiner deve ser precedido por uma barra invertida. (Observe que Windows PowerShell permite que você use barras para compatibilidade com outros PowerShells.)

Depois que o contêiner e os subcontêineres forem especificados, você deve fornecer o nome do item, precedido por uma barra invertida. Por exemplo, o nome totalmente qualificado do caminho para o arquivo Shell.dll no diretório C:\Windows\System32 é da seguinte maneira:

        C:\Windows\System32\Shell.dll

Neste caso, a unidade por meio da qual os contêineres são acessados é a C:, o contêiner de nível superior é o Windows, o subcontêiner é System32 (localizado dentro do contêiner Windows), e o item é Shell.dll.

Em algumas situações, você não precisa especificar um nome de caminho totalmente qualificado e pode usar um nome de caminho relativo. Um nome de caminho relativo baseia-se no local de trabalho atual. Windows PowerShell permite que você identifique um item com base na sua localização em relação ao local de trabalho atual. Você pode especificar nomes de caminho relativo usando caracteres especiais. A tabela a seguir descreve cada um desses caracteres e fornece exemplos de nomes de caminho relativo e nomes de caminho totalmente qualificado. Os exemplos na tabela são baseados no diretório de trabalho atual que está sendo definido como C:\Windows.

    Symbol Description                Relative path    Fully qualified path
    ------ -------------------------- ---------------- --------------------
    .      Current working location   .\System         c:\Windows\System
    ..     Parent of current working  ..\Program Files c:\Program Files
           location
    \      Drive root of current      \Program Files   c:\Program Files
           working location
    [none] No special characters      System           c:\Windows\System

Ao usar um nome de caminho em um comando, você insere esse nome da mesma maneira que usa um nome de caminho totalmente qualificado ou um nome relativo. Por exemplo, suponha que o seu diretório de trabalho atual seja C:\Windows. O comando Get-ChildItem a seguir recupera todos os itens no diretório C:\Techdocs:

        Get-ChildItem \techdocs

A barra invertida indica que a raiz da unidade do local de trabalho atual deve ser usada. Como o diretório de trabalho é C:\Windows, a raiz da unidade é a unidade C: Como o diretório techdocs está localizado fora da raiz, você precisa especificar apenas a barra invertida.

Você pode alcançar os mesmos resultados usando o seguinte comando:

        Get-ChildItem c:\techdocs

Independentemente de você usar um nome de caminho totalmente qualificado ou um caminho relativo, um nome de caminho é importante não apenas porque ele localiza um item, mas também porque ele identifica exclusivamente o item mesmo se esse item compartilhar o mesmo nome que outro item em um contêiner diferente.

Por exemplo, suponha que você tenha dois arquivos que têm o nome Results.txt. O primeiro arquivo está em um diretório chamado C:\Techdocs\Jan, e o segundo arquivo está em um diretório chamado C:\Techdocs\Feb. O nome do caminho para o primeiro arquivo (C:\Techdocs\Jan\Results.txt) e o nome do caminho para o segundo arquivo (C:\Techdocs\Feb\Results.txt) permitem distinguir claramente entre os dois arquivos.

CONSULTE TAMBÉM

about_Locations