Split-Path

Módulo:

Microsoft.PowerShell.Management Module

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

PS C:\> 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 arquivo

PS C:\> 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 informa Split-Path para exibir os itens aos quais o caminho dividido faz referência, em vez de exibir o caminho dividido.

Como todos os comandos Split-Path, este comando retorna cadeias de caracteres. Ele não retorna FileInfo objetos 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

Este comando retorna apenas os contêineres pai do caminho. Como não inclui parâmetros para especificar a divisão, Split-Path usa o padrão de local dividido, que é Parent.

Exemplo 4: Determina se um caminho é absoluto

PS C:\> 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

PS C:\> '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

-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:	False
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:	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 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.

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

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

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 o FileSystem ou provedores de registro, 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

System.String, System.Boolean

Split-Path retorna cadeias de caracteres de texto. Quando você especifica o parâmetro Resolve, Split-Path retorna uma cadeia de caracteres que descreve o local dos itens; ele não retorna objetos que representam os itens, como um FileInfo ou objeto RegistryKey.

Quando você especifica o parâmetro IsAbsolute, Split-Path retorna um valor de 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 foi projetado para trabalhar 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.

Ligações Relacionadas

• Convert-Path
• Join-Path
• Resolve-Path
• Test-Path