Compartilhar via

Set-Location

  • Referência
Módulo:
Microsoft.PowerShell.Management

Define o local de trabalho atual como um local especificado.

Sintaxe

Set-Location
   [[-Path] <String>]
   [-PassThru]
   [-UseTransaction]
   [<CommonParameters>]
Set-Location
   -LiteralPath <String>
   [-PassThru]
   [-UseTransaction]
   [<CommonParameters>]
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 de registro ou qualquer caminho de provedor.

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

Exemplos

Exemplo 1: Definir o local atual

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

PS HKLM:\>

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

Exemplo 2: Definir o local atual e exibir esse local

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

Path
----
Env:\

PS Env:\>

Esse comando define o local atual como a raiz da unidade Env: . Ele usa o parâmetro PassThru para direcionar o PowerShell para retornar um objeto PathInfo que representa a localização env: .

Exemplo 3: Definir o local como a unidade C:

PS C:\> Set-Location C:

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

Exemplo 4: Definir o local atual como uma pilha nomeada

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

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

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

Parâmetros

-LiteralPath

Especifica um caminho do local. O valor do parâmetro LiteralPath é usado exatamente como ele é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Aspas simples dizem ao Windows PowerShell para não interpretar nenhum caractere como sequências de escape.

Tipo:String
Aliases:PSPath
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-StackName

Especifica o nome da pilha de localização que esse cmdlet faz a pilha de localização atual. Insira um nome de pilha de localização. Para indicar a pilha de localização 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-UseTransaction

Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Tipo:SwitchParameter
Aliases:usetx
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode redirecionar uma cadeia de caracteres que contém um caminho, mas não um caminho literal, para este cmdlet.

Saídas

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

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

Observações

  • O cmdlet Set-Location foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.

    Uma pilha é uma lista de última entrada e primeira saída na qual apenas o item adicionado mais recentemente pode ser acessado. Você adiciona itens a uma pilha na ordem em que os usa e os recupera para uso na ordem inversa. O PowerShell permite armazenar locais do provedor em pilhas de localização. O PowerShell cria uma pilha de localização padrão sem nome. Você pode criar várias pilhas de localização nomeadas. Se você não especificar um nome de pilha, o PowerShell usará a pilha de localização atual. Por padrão, o local padrão sem nome é a pilha de localização atual, mas você pode usar o cmdlet Set-Location para alterar a pilha de localização atual.

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

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

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

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

    • Para criar uma nova pilha de localização, 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 localização padrão sem nome só é totalmente acessível quando é a pilha de localização atual. Se você fizer uma pilha de localização nomeada a pilha de localização 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 ("").