Split-Path
Retorna a parte especificada de um caminho.
Sintaxe
ParentSet (Predefinição)
Split-Path
[-Path] <String[]>
[-Parent]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
NoQualifierSet
Split-Path
[-Path] <String[]>
[-NoQualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LeafSet
Split-Path
[-Path] <String[]>
[-Leaf]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
QualifierSet
Split-Path
[-Path] <String[]>
[-Qualifier]
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
IsAbsoluteSet
Split-Path
[-Path] <String[]>
[-Resolve]
[-IsAbsolute]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPathSet
Split-Path
-LiteralPath <String[]>
[-Resolve]
[-Credential <PSCredential>]
[-UseTransaction]
[<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 a 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 Resolve, 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 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.
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 Resolve, 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
Este 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 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:\Users\User01\My Documents\My Pictures' | Split-Path
C:\Users\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 |
-IsAbsolute
Indica que esse cmdlet retorna $true se o caminho for absoluto e $false se for relativo. No Windows, uma cadeia de caracteres de caminho absoluto deve começar com um especificador de unidade de provedor, como C: ou HKCU:. Um caminho relativo começa com um ponto (.) ou dois pontos (..).
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: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
LeafSet
| Position: | Named |
| Obrigatório: | False |
| 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 |
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: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | 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 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 |
NoQualifierSet
| 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 |
QualifierSet
| 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 FileSystem ou Registry, 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: | False |
| 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 |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido somente quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Usetx |
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, Leafe 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.
