Split-Path
Retorna a parte especificada de um caminho.
Sintaxe
ParentSet (Padrão)
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
-Leaf
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LeafBaseSet
Split-Path
[-Path] <String[]>
-LeafBase
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
ExtensionSet
Split-Path
[-Path] <String[]>
-Extension
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
-Qualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
-NoQualifier
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
-IsAbsolute
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
O cmdlet Split-Path 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. Se você dividir um caminho sem especificar outros parâmetros, Split-Path retornará a parte pai do caminho fornecido.
O comando Split-Path retorna cadeias de caracteres. Ele não retorna objetos como FileInfo ou outros itens de objeto, como fazem os comandos *-Item.
Exemplos
Exemplo 1: obter o qualificador de um caminho
Split-Path -Path "HKCU:\Software\Microsoft" -Qualifier
HKCU:
Esse comando retorna apenas o qualificador do caminho. O qualificador é a unidade.
Exemplo 2: exibir parte do nome do arquivo do caminho
Ao usar o parâmetro Leaf, Split-Path retorna apenas o último item na cadeia de caracteres de caminho fornecida, independentemente de esse item ser um arquivo ou um diretório.
Split-Path -Path .\folder1\*.txt -Leaf
*.txt
Split-Path -Path .\folder1\*.txt -Leaf -Resolve
file1.txt
file2.txt
Quando você usa o parâmetro Resolver, Split-Path resolve a cadeia de caracteres de caminho fornecida e retorna os itens referenciados pelo caminho.
Exemplo 3: obter o contêiner pai
Ao usar o parâmetro Pai, Split-Path retorna apenas a parte do contêiner pai da cadeia de caracteres de caminho fornecida. Se a cadeia de caracteres Path não contiver um contêiner pai, Split-Path retornará uma cadeia de caracteres vazia.
Split-Path -Path .\folder1\file1.txt -Parent
.\folder1
Split-Path -Path .\folder1\file1.txt -Parent -Resolve
D:\temp\test\folder1
Quando você usa o parâmetro Resolver, Split-Path resolve a cadeia de caracteres de caminho fornecida e retorna o caminho completo do contêiner pai.
Exemplo 4: determina se um caminho é absoluto
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.
Split-Path -Path ".\My Pictures\*.jpg" -IsAbsolute
False
Exemplo 5: alterar o local para um caminho especificado
Esse comando altera seu local para a pasta que contém o perfil do PowerShell.
PS C:\> Set-Location (Split-Path -Path $PROFILE)
PS C:\Users\User01\Documents\PowerShell>
O comando entre parênteses usa Split-Path para retornar apenas o pai do caminho armazenado na variável $PROFILE interna. O parâmetro Parent é 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
'C:\Users\User01\My Documents\My Pictures' | Split-Path
C:\Users\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
Esse parâmetro não é compatível com nenhum provedor instalado com o PowerShell. Para executar este cmdlet em nome de outro usuário ou elevar suas credenciais, use Invoke-Command.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ExtensionSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IsAbsolute
Indica que esse cmdlet retornará $true se o caminho for absoluto e $false se for relativo. No Windows, uma cadeia de caracteres de caminho absoluta deve começar com um especificador de unidade do provedor, como C: ou HKCU:. Um caminho relativo começa com um ponto (.) ou um ponto-ponto (..).
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
IsAbsoluteSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Leaf
Ao usar o parâmetro Leaf, Split-Path retorna apenas o último item na cadeia de caracteres de caminho fornecida, independentemente de esse item ser um arquivo ou um diretório.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LeafSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LeafBaseSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-LiteralPath
Especifica os caminhos que devem ser divididos. Diferente de Path, o valor de LiteralPath é usado exatamente como foi digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath, LP |
Conjuntos de parâmetros
LiteralPathSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-NoQualifier
Indica que este cmdlet retorna o 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 apenas \Test\Logs\Pass1.log.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NoQualifierSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Parent
Split-Path retorna apenas a parte do contêiner pai da cadeia de caracteres de caminho fornecida. Se a cadeia de caracteres Path não contiver um contêiner pai, Split-Path retornará uma cadeia de caracteres vazia.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ParentSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Path
Especifica os caminhos que devem ser divididos. Caracteres curinga são permitidos. Se o caminho incluir espaços, coloque-os entre aspas. Você também pode canalizar uma cadeia de caracteres de caminhos para esse cmdlet.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
ParentSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
LeafSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
LeafBaseSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
ExtensionSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
QualifierSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
NoQualifierSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
IsAbsoluteSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Qualifier
Indica que esse cmdlet retorna apenas o qualificador do caminho especificado. Para os provedores FileSystem ou Registry, o qualificador é a unidade do caminho do provedor, como C: ou HKCU:.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
QualifierSet
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Resolve
Indica que esse cmdlet exibe os itens referenciados pelo caminho dividido resultante em vez de exibir os elementos do caminho.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
É possível direcionar uma cadeia de caracteres que contém um caminho para este cmdlet.
Saídas
String
Esse cmdlet retorna cadeias de caracteres de texto. Quando você especifica o parâmetro Resolver, 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.
Boolean
Quando você especifica o parâmetro IsAbsolute, este cmdlet retorna um valor booleano .
Observações
Os parâmetros de local de divisão (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 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 Path junto com vários provedores. Eles incluem os provedores FileSystem, Registry e Certificate.
Split-Pathfoi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digiteGet-PSProvider. Para obter mais informações, consulte about_Providers.
