Share via


about_Path_Syntax

Descrição breve

Descreve os formatos de nome de caminho completo e relativo no PowerShell.

Descrição longa

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

No PowerShell, os nomes de caminho são divididos em um dos dois tipos: totalmente qualificados e relativos. Um nome de caminho totalmente qualificado consiste em todos os elementos que compõem um caminho. A seguinte sintaxe mostra os elementos em um nome de caminho totalmente qualificado:

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

O <espaço reservado do provedor> refere-se ao provedor do PowerShell por meio do qual você acessa o armazenamento de dados. Por exemplo, o provedor 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 da unidade são exclusivos em todos os provedores.

O <espaço reservado da unidade> refere-se à unidade do PowerShell compatível com um provedor específico do PowerShell. No caso do provedor FileSystem, as unidades do PowerShell são mapeadas para as unidades do Windows configuradas em seu sistema. Por exemplo, se o sistema incluir uma unidade A: e uma unidade C:, o provedor FileSystem criará as mesmas unidades no PowerShell.

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

Depois que o contêiner e os subcontenentes tiverem sido especificados, você deverá fornecer o nome do item, precedido por uma barra invertida. Por exemplo, o nome do caminho totalmente qualificado para o arquivo Shell.dll no diretório C:\Windows\System32 é o seguinte:

C:\Windows\System32\Shell.dll

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

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

Símbolo Descrição Caminho relativo Caminho completo
. Local atual .\Sistema c:\Windows\System
.. Pai do local atual .. \Arquivos de Programas c:\Arquivos de Programas
\ Raiz da unidade atual \Arquivos de Programas c:\Arquivos de Programas
local
[none] Sem caracteres especiais Sistema c:\Windows\System

Ao usar um nome de caminho em um comando, você insere esse nome da mesma forma se usa um nome de caminho totalmente qualificado ou um relativo. Por exemplo, suponha que seu diretório de trabalho atual seja C:\Windows. O seguinte comando Get-ChildItem 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 obter os mesmos resultados usando o seguinte comando:

Get-ChildItem c:\techdocs

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

Por exemplo, suponha que você tenha dois arquivos que são cada um nomeado 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 do primeiro arquivo (C:\Techdocs\Jan\Results.txt) e o nome do caminho do segundo arquivo (C:\Techdocs\Feb\Results.txt) permitem distinguir claramente entre os dois arquivos.

Confira também