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