Split-Path
Retorna a parte especificada de um caminho.
Syntax
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Leaf
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-LeafBase
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Extension
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-Qualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
-NoQualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
[-Path] <String[]>
[-Resolve]
-IsAbsolute
[-Credential <PSCredential>]
[<CommonParameters>]
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
O Split-Path
cmdlet 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 que são referenciados pelo caminho dividido e dizer 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
Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Este comando retorna apenas o qualificador do caminho. O qualificador é a unidade.
Exemplo 2: Exibir nomes de arquivos
Split-Path -Path "C:\Test\Logs\*.log" -Leaf -Resolve
Pass1.log
Pass2.log
...
Este 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 dos arquivos.
O parâmetro Resolve diz Split-Path
para exibir os itens aos quais o caminho dividido faz referência, em vez de exibir o caminho dividido.
Como todos os Split-Path
comandos, este comando retorna cadeias de caracteres. Ele não retorna objetos FileInfo que representam os arquivos.
Exemplo 3: Obter o contêiner pai
Split-Path -Parent "C:\WINDOWS\system32\WindowsPowerShell\V1.0\about_*.txt"
C:\WINDOWS\system32\WindowsPowerShell\V1.0
Este comando retorna apenas os contêineres pai do caminho. Como ele não inclui parâmetros para especificar a divisão, Split-Path
usa o padrão de local de divisão, que é Pai.
Exemplo 4: Determina se um caminho é absoluto
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>
Este comando altera seu local para a pasta que contém o perfil do PowerShell.
O comando entre parênteses usa Split-Path
para retornar apenas o pai do caminho armazenado na variável interna $Profile
. O parâmetro Parent é o parâmetro de local de divisão padrão.
Portanto, você pode omiti-lo do comando. Os parênteses direcionam o PowerShell para executar o comando primeiro. Esta é uma maneira útil de mover para uma pasta que tem um nome de caminho longo.
Exemplo 6: Dividir um caminho usando o pipeline
'C:\Documents and Settings\User01\My Documents\My Pictures' | Split-Path
C:\Documents and Settings\User01\My Documents
Este comando usa um operador de pipeline (|
) para enviar um caminho para Split-Path
. O caminho é colocado entre aspas para indicar que é um único token.
Parâmetros
-Credential
Nota
Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Extension
Indica que esse cmdlet retorna apenas a extensão da folha. Por exemplo, no caminho C:\Test\Logs\Pass1.log
, ele retorna apenas .log
.
Esse parâmetro foi introduzido no PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LeafBase
Indica que esse cmdlet retorna apenas o nome base da folha. Por exemplo, no caminho C:\Test\Logs\Pass1.log
, ele retorna apenas Pass1
.
Esse parâmetro foi introduzido no PowerShell 6.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LiteralPath
Especifica os caminhos a serem divididos. Ao contrário de Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como caracteres curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 Parent é o parâmetro de local de divisão padrão.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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:
.
Type: | SwitchParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Resolve
Indica que esse cmdlet exibe os itens referenciados pelo caminho dividido resultante em vez de exibir os elementos path.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode canalizar uma cadeia de caracteres que contenha um caminho para esse cmdlet.
Saídas
Este cmdlet retorna cadeias de caracteres de texto. Quando você especifica o parâmetro Resolve , ele 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 , esse cmdlet retorna um valor booleano .
Notas
Os parâmetros de localização dividida (Qualifier, Parent, Extension, Leaf, LeafBase e 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 onde 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, Join ou outros manipuladores de caminho.
Você pode usar os cmdlets Path junto com vários provedores. Estes incluem os provedores FileSystem, Registry e Certificate.
Split-Path
é projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digiteGet-PSProvider
. Para obter mais informações, consulte about_Providers.
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários