Split-Path
Retorna a parte especificada de um caminho.
Sintaxe
ParentSet (Predefiniçã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 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 é o impulso.
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 $Profile interna. 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 aceder a uma pasta com 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
Observação
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.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ExtensionSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-IsAbsolute
Indica que esse cmdlet retorna $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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
IsAbsoluteSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
LeafSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
LeafBaseSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-LiteralPath
Especifica os caminhos a serem divididos. Ao contrário Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como um caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PSPath, LP |
Conjuntos de parâmetros
LiteralPathSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-NoQualifier
Indica que esse cmdlet retorna o caminho sem o qualificador. Para os provedores de sistema de ficheiros ou de registo, 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NoQualifierSet
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ParentSet
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Path
Especifica os caminhos a serem divididos. Caracteres coringa são permitidos. Se o caminho incluir espaços, coloque-o entre aspas. Você também pode canalizar um caminho para esse cmdlet.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
ParentSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
LeafSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
LeafBaseSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
ExtensionSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
QualifierSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
NoQualifierSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
IsAbsoluteSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Qualifier
Indica que esse cmdlet retorna apenas o qualificador do caminho especificado. Para os provedores de sistema de ficheiros ou de registo, o qualificador é a unidade do caminho do provedor, como C: ou HKCU:.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
QualifierSet
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Resolve
Indica que este cmdlet mostra os itens referenciados pelo caminho dividido resultante em vez de mostrar os elementos do caminho.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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
Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este cmdlet.
Saídas
String
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.
Boolean
Quando o/a utilizador(a) especifica o parâmetro IsAbsolute, este cmdlet retorna um valor Booleano.
Notas
Os parâmetros de localização dividida (Qualifier, Parent, Extension, Leaf, LeafBasee NoQualifier) são exclusivos. Você pode usar apenas um em cada comando.
Os cmdlets que contêm o substantivo Caminho
(os cmdlets Caminho ) trabalham 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. Utilize-os da forma como se utilizaria Dirname, Normpath, Realpath, Joinou outros manipuladores de caminhos. Você pode usar os cmdlets Path em conjunto com vários fornecedores. 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.