Compartilhar via


Split-Path

Retorna a parte especificada de um caminho.

Sintaxe

Split-Path [-IsAbsolute] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]

Split-Path [-Leaf] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]

Split-Path [-NoQualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]

Split-Path [-Parent] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]

Split-Path [-Qualifier] [-Path] <string[]> [-Credential <PSCredential>] [-LiteralPath <string[]>] [-Resolve] [-UseTransaction] [<CommonParameters>]

Descrição

O cmdlet Split-Path retorna apenas a parte especifica de um caminho, como um diretório pai, um diretório filho ou um nome de arquivo. Ele também pode exibir os itens referenciados pelo caminho dividido e informar se o caminho é relativo ou absoluto.

Você pode usar esse cmdlet para exibir ou enviar apenas uma parte selecionada de um caminho.

Parâmetros

-Credential <PSCredential>

Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.

Digite um nome de usuário, como “User01” ou “Domain01\User01”. Ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.

Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-IsAbsolute

Retorna TRUE se o caminho for absoluto e FALSE se for relativo. Um caminho absoluto possui comprimento maior que zero e não usa (.) para indicar o caminho atual.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Leaf

Retorna somente o último item ou contêiner do caminho. Por exemplo, no caminho "C:\Test\Logs\Pass1.log", ele retorna somente "Pass1.log".

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-LiteralPath <string[]>

Especifica os caminhos a serem divididos. Ao contrário de Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-NoQualifier

Retorna somente caminho, sem o qualificador. Para os provedores FileSystem ou Registry, o qualificador é a unidade do caminho do provedor, como C: ou HKCU:. Por exemplo, no caminho "C:\Test\Logs\Pass1.log", ele retorna somente "C:\Test\Logs\Pass1.log".

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Parent

Retorna somente os contêineres pais do item ou do contêiner especificado pelo caminho. Por exemplo, no caminho "C:\Test\Logs\Pass1.log", ele retorna "C:\Test\Logs". O parâmetro Parent é o parâmetro padrão de local de divisão.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Path <string[]>

Especifica os caminhos a serem divididos. Os caracteres curinga são permitidos. Se o caminho incluir espaços, coloque-o entre aspas. Também é possível enviar um caminho para Split-Path.

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-Qualifier

Retorna somente o qualificador do caminho especificado. Para os provedores FileSystem ou Registry, o qualificador é a unidade do caminho do provedor, como C: ou HKCU:.

Necessário?

false

Posição?

2

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Resolve

Exibe os itens referenciados pelo caminho dividido resultante, em vez de exibir os elementos do caminho.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-UseTransaction

Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

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 enviar uma cadeia de caracteres que contém um caminho para Split-Path.

Saídas

System.String

O cmdlet Split-Path retorna cadeias de caracteres de texto. Quando você usa o parâmetro Resolve, Split-Path retorna uma cadeia de caracteres que descreve o local dos itens; ele não retorna objetos que representam os itens, como um objeto FileInfo ou RegistryKey.

Observações

Os parâmetros de local de divisão (Qualifier, Parent, Leaf e NoQualifier) são exclusivos. É possível usar somente um em cada comando.

Os cmdlets que contêm o nome Path (os cmdlets Path) manipulam os nomes de caminho e os retornam em um formato conciso que pode ser interpretado por todos os provedores do Windows PowerShell. Eles foram criados para o uso em programas e scripts em que você deseja exibir todo ou parte de um caminho em um determinado formato. Utilize-os como o faria com Dirname, Normpath, Realpath, Join ou outros manipuladores de caminho.

Você pode usar os cmdlets Path com vários provedores, incluindo FileSystem, Registry e Certificate.

O cmdlet Split-Path foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PSProvider". Para obter mais informações, consulte about_Providers.

Exemplo 1

C:\PS>split-path "HKCU:\Software\Microsoft" -qualifier

HKCU:

Descrição
-----------
Esse comando retorna somente o qualificador (a unidade) do caminho.





Exemplo 2

C:\PS>split-path "C:\Test\Logs\*.log" -leaf -resolve

Pass1.log
Pass2.log
...

Descrição
-----------
Esse comando exibe os arquivos referenciados pelo caminho dividido. Como esse caminho é dividido até o último item (a "folha"), somente os nomes dos arquivos dos caminhos são exibidos. 

O parâmetro Resolve informa Split-Path para exibir os itens que o caminho dividido referencia, em vez de exibir o caminho dividido.

Como todos os comandos Split-Path, esse comando retorna cadeias de caracteres. Ele não retorna objetos FileInfo que representam os arquivos.





Exemplo 3

C:\PS>split-path "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"

C:\WINDOWS\system32\WindowsPowerShell\V1.0

Descrição
-----------
Esse comando retorna somente os contêineres pais do caminho. Como ele não inclui quaisquer parâmetros para especificar a divisão, Split-Path usa o local de divisão padrão, Parent.





Exemplo 4

C:\PS>split-path ".\My Pictures\*.jpg" -IsAbsolute

False

Descrição
-----------
Esse comando determina se o caminho é relativo ou absoluto. Nesse caso, como o caminho é relativo ao diretório atual, que é representado por um ponto (.), ele retorna FALSE ($false).





Exemplo 5

C:\PS>set-location (split-path $profile)

PS C:\Documents and Settings\juneb\My Documents\WindowsPowerShell>

Descrição
-----------
Esse comando altera o local para o diretório que contém o perfil do Windows PowerShell. 
O comando entre parênteses usa o cmdlet Split-Path para retornar somente o pai do caminho armazenado na variável interna $Profile. (O parâmetro Parent é o parâmetro padrão de local dividido, assim, você pode omiti-lo do comando.) Os parênteses direcionam o Windows PowerShell a executar o comando primeiro. Essa é uma forma muito útil de navegação até um diretório com um nome de caminho longo.





Exemplo 6

C:\PS>'C:\Documents and Settings\User01\My Documents\My Pictures' | split-path

C:\Documents and Settings\User01\My Documents

Descrição
-----------
Esse comando usa um operador de pipeline (|) para enviar um caminho ao cmdlet Split-Path. O caminho está entre aspas para indicar que ele é um token único.





Consulte também

Conceitos

about_Providers
Test-Path
Convert-Path
Resolve-Path
Join-Path