Set-Location
Define o local de trabalho atual como um local especificado.
Sintaxe
Set-Location [-LiteralPath] <string> [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [[-Path] <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Set-Location [-StackName <string>] [-PassThru] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Set-Location define o local de trabalho para um local especificado. Esse local pode ser um diretório, um subdiretório, um local do Registro ou outra pilha de locais.
Parâmetros
-LiteralPath <string>
Especifica um caminho para o local. O valor do parâmetro LiteralPath é usado exatamente como digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-PassThru
Passa um objeto que representa o local para o pipeline. Por padrão, este cmdlet não gera nenhuma saída.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Path <string>
Esse parâmetro é usado na especificação do caminho para um novo local de trabalho.
Necessário? |
false |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
Aceitar caracteres curinga? |
false |
-StackName <string>
O nome da pilha para a qual o local está sendo definido.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
System.String Você pode enviar uma cadeia de caracteres que contém um caminho (mas não um caminho literal) para Set-Location. |
Saídas |
Nenhum ou System.Management.Automation.PathInfo Quando você usa o parâmetro PassThru, o Set-Location gera um objeto System.Management.Automation.PathInfo que representa o local. Caso contrário, esse cmdlet não gera nenhuma saída. |
Observações
O cmdlet Set-Location foi desenvolvido para funcionar 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.
Exemplo 1
C:\PS>set-location HKLM:
Descrição
-----------
Isso definirá o local atual para o especificado; nesse caso, o provedor HKLM.
Exemplo 2
C:\PS>set-location env: -passthru
Path
----
Env:\
Descrição
-----------
Isso definirá o local atual para o especificado; nesse caso, o provedor de variável de ambiente.
Exemplo 3
C:\PS>set-location C:
Descrição
-----------
Isso definirá o local atual para o especificado; nesse caso, a unidade C: no provedor de sistema de arquivos.