Compartilhar via

Split-Path

  • Referência
Módulo:
Microsoft.PowerShell.Management

Retorna a parte especificada de um caminho.

Sintaxe

Split-Path
     [-Path] <String[]>
     [-Parent]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-NoQualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Leaf]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Qualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     [-Path] <String[]>
     [-Resolve]
     [-IsAbsolute]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]
Split-Path
     -LiteralPath <String[]>
     [-Resolve]
     [-Credential <PSCredential>]
     [-UseTransaction]
     [<CommonParameters>]

Description

O cmdlet caminho dividido retorna apenas a parte especificada de um caminho, como a pasta pai, uma subpasta ou um nome de arquivo. Ele também pode obter itens referenciados pelo caminho dividido e informar se o caminho é relativo ou absoluto.

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

Exemplos

Exemplo 1: Obter o qualificador de um caminho

PS C:\> Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:

Esse comando retorna apenas o qualificador do caminho. O qualificador é a unidade.

Exemplo 2: Exibir nomes de arquivo

PS C:\> Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...

Esse comando exibe os arquivos referenciados pelo caminho dividido. Como esse caminho é dividido para o último item, também conhecido como folha, o comando exibe apenas os nomes de arquivo.

O parâmetro resolver informa dividir caminho para exibir os itens que o caminho dividido faz referência, em vez de exibir o caminho dividido.

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

Exemplo 3: Obter o contêiner pai

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

Esse comando retorna apenas os contêineres pai do caminho. Como ele não inclui parâmetros para especificar a divisão, de caminho dividido usa o padrão de local dividido, que é pai.

Exemplo 4: determina se um caminho é absoluto

PS C:\> Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False

Este comando determina se o caminho é relativo ou absoluto. Nesse caso, como o caminho é relativo à pasta atual, que é representada por um ponto (.), ele retorna $False.

Exemplo 5: alterar o local para um caminho especificado

PS C:\> Set-Location (Split-Path -Path $profile)
PS C:\Documents and Settings\User01\My Documents\WindowsPowerShell>

Esse comando altera seu local para a pasta que contém o perfil do PowerShell.

O comando entre parênteses usa caminho dividido para retornar apenas o pai do caminho armazenado na variável de $Profile interna. O parâmetro pai é o parâmetro de local de divisão padrão. Portanto, você pode omitê-lo do comando. Os parênteses orientam o PowerShell a executar o comando primeiro. Essa é uma maneira útil de migrar para uma pasta que tem um nome de caminho longo.

Exemplo 6: Dividir um caminho usando o pipeline

PS C:\> 'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents

Esse comando usa um operador de pipeline (|) para enviar um caminho para de caminho dividido. O caminho está entre aspas para indicar que é um único token.

Parâmetros

-Credential

Nota

Esse parâmetro não tem suporte para nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IsAbsolute

Indica que esse cmdlet retornará $True se o caminho for absoluto e $False se for relativo. Um caminho absoluto tem um comprimento maior que zero e não usa um ponto (.) para indicar o caminho atual.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Leaf

Indica que esse cmdlet retorna apenas o último item ou contêiner no caminho. Por exemplo, no caminho C:\Test\Logs\Pass1.log, ele retorna apenas Pass1.log.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LiteralPath

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

Tipo:String[]
Aliases:PSPath
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoQualifier

Indica que esse cmdlet retorna o caminho sem o qualificador. Para o FileSystem ou provedores de registro, o qualificador é a unidade do caminho do provedor, como C: ou HKCU:. Por exemplo, no caminho C:\Test\Logs\Pass1.log, ele retorna apenas \Test\Logs\Pass1.log.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Parent

Indica que esse cmdlet retorna apenas os contêineres pai 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 pai é o parâmetro de local de divisão padrão.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

Especifica os caminhos a serem divididos. Caracteres curinga são permitidos. Se o caminho incluir espaços, coloque-o entre aspas. Você também pode canalizar um caminho para esse cmdlet.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Qualifier

Indica que esse cmdlet retorna apenas o qualificador do caminho especificado. Para o FileSystem ou provedores de registro, o qualificador é a unidade do caminho do provedor, como C: ou HKCU:.

Tipo:SwitchParameter
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Resolve

Indica que esse cmdlet exibe os itens referenciados pelo caminho de divisão resultante em vez de exibir os elementos de caminho.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseTransaction

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

Tipo:SwitchParameter
Aliases:usetx
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um caminho para este cmdlet.

Saídas

System.String, System.Boolean

caminho dividido retorna cadeias de caracteres de texto. Quando você especifica o parâmetro resolver , de caminho dividido 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.

Quando você especifica o parâmetro IsAbsolute, de caminho dividido retorna um valor de booliano .

Observações

  • Os parâmetros de local dividido (Qualifier, Parent, Leafe NoQualifier) são exclusivos. Você pode usar apenas um em cada comando.

    Os cmdlets que contêm o substantivo Path (os cmdlets Path) funcionam com nomes de caminho e retornam os nomes em um formato conciso que todos os provedores do PowerShell podem interpretar. Eles são projetados para uso em programas e scripts em que você deseja exibir todo ou parte de um nome de caminho em um formato específico. Use-os da maneira que você usaria Dirname, Normpath, Realpath, Joinou outros manipuladores de caminho.

    Você pode usar os cmdlets de caminho junto com vários provedores. Eles incluem os provedores FileSystem, Registry e Certificate.

    de Caminho Dividido foi projetado para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.