Partilhar via

Set-Location

Módulo:
Microsoft.PowerShell.Management Module

Define o local de trabalho atual como um local especificado.

Sintaxe

Path (Predefinição) 

Set-Location
    [[-Path] <String>]
    [-PassThru]
    [-UseTransaction]
    [<CommonParameters>]

LiteralPath 

Set-Location
    -LiteralPath <String>
    [-PassThru]
    [-UseTransaction]
    [<CommonParameters>]

Stack 

Set-Location
    [-PassThru]
    [-StackName <String>]
    [-UseTransaction]
    [<CommonParameters>]

Description

O cmdlet Set-Location define o local de trabalho como um local especificado. Esse local pode ser um diretório, um subdiretório, um local do Registro ou qualquer caminho de provedor.

Você também pode usar o parâmetro StackName para tornar uma pilha de local nomeado a pilha de local atual. Para obter mais informações sobre pilhas de localização, consulte as Notas.

Exemplos

Exemplo 1: Definir a localização atual

PS C:\> Set-Location -Path "HKLM:"

PS HKLM:\>

Este comando define o local atual como a raiz da unidade HKLM:.

Exemplo 2: Definir o local atual e exibi-lo

PS C:\> Set-Location -Path "Env:" -PassThru

Path
----
Env:\

PS Env:\>

Este comando define o local atual para a raiz da unidade Env:. Ele usa o parâmetro PassThru para direcionar o PowerShell a retornar um objeto PathInfo que representa o local Env:.

Exemplo 3: Defina a localização para a unidade C:

PS C:\> Set-Location C:

Este comando define o local atual da unidade C: no provedor FileSystem.

Exemplo 4: Definir o local atual como uma pilha nomeada

PS C:\> Set-Location -StackName "WSManPaths"

Este comando torna a pilha de localização WSManPaths a pilha de localização atual.

Os cmdlets *-Location usam a pilha de local atual, a menos que uma pilha de local diferente seja especificada no comando. Para obter informações sobre pilhas de localização, consulte as Notas.

Parâmetros

-LiteralPath

Especifica um caminho do local. O valor do parâmetro 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.

As aspas simples dizem ao Windows PowerShell para não interpretar nenhum caractere 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

LiteralPath
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-PassThru

Retorna um PathInfo objeto que representa o local. Por padrão, esse cmdlet não gera nenhuma saída.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
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

-Path

Especifique o caminho de um novo local de trabalho. Se nenhum caminho for fornecido, Set-Location padrão para o diretório base do usuário atual. Quando curingas são usados, o cmdlet escolhe o primeiro caminho que corresponde ao padrão curinga.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

Path
Position:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StackName

Especifica o nome da pilha de local que esse cmdlet torna a pilha de local atual. Insira um nome de pilha de localização. Para indicar a pilha de local padrão sem nome, digite $null ou uma cadeia de caracteres vazia ("").

Os cmdlets *-Location atuam na pilha atual, a menos que você use o parâmetro StackName para especificar uma pilha diferente.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Stack
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
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 canalizar uma cadeia de caracteres que contém um caminho, mas não um caminho literal, para esse cmdlet.

Saídas

None, System.Management.Automation.PathInfo, System.Management.Automation.PathInfoStack

Este cmdlet não gera nenhuma saída, a menos que você especifique o parâmetro PassThru. Usando PassThru com Path ou LiteralPath gera um PathInfo objeto que representa o novo local. Usando PassThru com StackName gera um PathInfoStack objeto que representa o novo contexto de pilha.

Notas

  • O cmdlet Set-Location 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.

    Uma pilha é uma lista de último a entrar, primeiro a sair, na qual apenas o item adicionado mais recentemente pode ser acessado. Você adiciona itens a uma pilha na ordem em que os usa e, em seguida, recupera-os para uso na ordem inversa. O PowerShell permite armazenar locais de provedores em pilhas de locais. O PowerShell cria uma pilha de local padrão sem nome. Você pode criar várias pilhas de locais nomeados. Se você não especificar um nome de pilha, o PowerShell usará a pilha de local atual. Por padrão, o local padrão sem nome é a pilha de local atual, mas você pode usar o cmdlet Set-Location para alterar a pilha de local atual.

  • Para gerenciar pilhas de localização, use os cmdlets *-Location, da seguinte maneira:

    • Para adicionar um local a uma pilha de locais, use o cmdlet Push-Location.

    • Para obter um local de uma pilha de locais, use o cmdlet Pop-Location.

    • Para exibir os locais na pilha de locais atual, use o parâmetro Stack do cmdlet Get-Location. Para exibir os locais em uma pilha de locais nomeados, use o parâmetro StackName de Get-Location.

    • Para criar uma nova pilha de locais, use o parâmetro StackName de Push-Location. Se você especificar uma pilha que não existe, Push-Location criará a pilha.

    • Para tornar uma pilha de localização a pilha de localização atual, use o parâmetro StackName de Set-Location.

      A pilha de local padrão sem nome é totalmente acessível somente quando é a pilha de local atual. Se você tornar uma pilha de local nomeada a pilha de local atual, não poderá mais usar Push-Location ou Pop-Location cmdlets adicionar ou obter itens da pilha padrão ou usar Get-Location para exibir os locais na pilha sem nome. Para tornar a pilha sem nome a pilha atual, use o parâmetro StackName de Set-Location com um valor de $null ou uma cadeia de caracteres vazia ("").