Split-Path

Referência

Módulo:: Microsoft.PowerShell.Management

Retorna a parte especificada de um caminho.

Syntax

Split-Path
     [-Path] <String[]>
     [-Parent]
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]

Split-Path
     [-Path] <String[]>
     [[-Qualifier]]
     [-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[]>
     [-NoQualifier]
     [-Resolve]
     [-Credential <PSCredential>]
     [<CommonParameters>]

Split-Path
     [-Path] <String[]>
     [-Resolve]
     [-IsAbsolute]
     [-Credential <PSCredential>]
     [<CommonParameters>]

Split-Path
     -LiteralPath <String[]>
     [-Resolve]
     [-Credential <PSCredential>]
     [<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. Também pode obter itens que são referenciados pelo caminho de divisão 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 que são referenciados pelo caminho de divisão. 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 o Caminho dividido para exibir os itens que o caminho dividido faz referência, 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: 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, Split-Path 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

Esse 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 Split-Path 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 mover 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 Split-Path. O caminho é colocado entre aspas para indicar que se trata de um único token.

Parâmetros

-Credential

Observação

Não há suporte para esse parâmetro em nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar este 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:	False
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:	False
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:	False
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:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

Especifica os caminhos que serão divididos. Ao contrário de Path, 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.

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 os provedores de sistema de arquivos ou registro, o qualificador é a unidade do caminho de 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:	False
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 Pai é 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 que serão divididos. Caracteres curinga são permitidos. Se o caminho incluir espaços, coloque-os entre aspas. Você também pode canalizar um caminho para este 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 os provedores de sistema de arquivos ou registro, o qualificador é a unidade do caminho de provedor, como C: ou HKCU:.

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	False
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 do caminho.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

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

Saídas

System.String, System.Boolean

Split-Path retorna cadeias de caracteres de texto. Quando você especifica o parâmetro Resolver , 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 .

Quando você especifica o parâmetro IsAbsolute , Split-Path retorna um valor booliano .

Observações

Os parâmetros de local dividido (Qualificador, Pai, Extensão, Folha, LeafBase e NoQualifier) são exclusivos. Você pode usar somente uma opção 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 foram projetados para uso em programas e scripts onde você deseja exibir uma parte ou todo 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. Eles incluem os provedores FileSystem, Registry e Certificate.

O Caminho dividido foi projetado 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.