현재 위치를 위치 목록("스택")의 맨 위에 추가합니다.

구문

Push-Location [[-LiteralPath] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]

Push-Location [[-Path] <string>] [-PassThru] [-StackName <string>] [-UseTransaction] [<CommonParameters>]

설명

Push-Location cmdlet은 현재 위치를 위치 목록("스택")의 맨 위에 추가합니다(밀어넣습니다). 현재 위치를 기본 스택 또는 사용자가 만든 스택에 밀어넣을 수 있습니다. 경로를 지정한 경우 Push-Location은 현재 위치를 스택에 밀어넣은 다음 경로에서 지정하는 위치로 변경합니다. 현재 위치가 아닌 위치는 스택에 넣을 수 없습니다.

매개 변수

-LiteralPath <string>

새 위치의 경로를 지정합니다. Path 매개 변수와 달리 LiteralPath 매개 변수 값은 입력한 그대로 사용됩니다. 와일드카드로 해석되는 문자는 없습니다. 경로에 이스케이프 문자가 포함된 경우 경로를 작은따옴표로 묶어야 합니다. 작은따옴표는 Windows PowerShell이 어떤 문자도 이스케이프 시퀀스로 해석하지 않도록 지시합니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-PassThru

위치를 나타내는 개체를 파이프라인으로 전달합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Path <string>

현재 위치를 스택의 맨 위에 추가한(밀어넣은) 다음 사용자 위치를 이 경로에서 지정하는 위치로 변경합니다. 이 cmdlet을 지원하는 공급자의 위치 경로를 입력하십시오. 와일드카드를 사용할 수 있습니다. 매개 변수 이름("Path")은 선택 사항입니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

true (ByValue, ByPropertyName)

와일드카드 문자 적용 여부

false

-StackName <string>

스택의 이름을 지정합니다. 현재 위치를 이 스택에 밀어넣으면 이 스택이 현재 스택이 됩니다. 스택이 아직 없는 경우에는 자동으로 만들어집니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

true (ByPropertyName)

와일드카드 문자 적용 여부

false

-UseTransaction

명령을 활성 트랜잭션에 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions를 참조하십시오.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.String

경로(리터럴 경로 아님)가 포함된 문자열을 Push-Location으로 파이프할 수 있습니다.

출력

없음 또는 System.Management.Automation.PathInfo

PassThru 매개 변수를 사용하는 경우 Push-Location은 위치를 나타내는 System.Management.Automation.PathInfo 개체를 생성합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다.

참고

또한 해당 기본 제공 별칭("pushd")으로 Push-Location을 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.

"스택"은 LIFO("last-in, first-out") 데이터 구조로, 맨 위 항목에만 액세스할 수 있는 세로 목록과 비슷합니다. 스택의 맨 위에만 항목을 추가할("밀어넣을") 수 있고 스택의 맨 위에서만 항목을 검색할("불러올") 수 있습니다. 아래쪽 항목으로 이동하려면 해당 항목보다 위에 있는 모든 항목을 검색해야 합니다.

Push-Location cmdlet은 모든 공급자가 제공하는 데이터에 사용할 수 있습니다. 세션에서 사용할 수 있는 공급자를 나열하려면 "Get-PSProvider"를 입력합니다. 자세한 내용은 about_Providers를 참조하십시오.

예 1

C:\PS>push-location C:\Windows

설명
-----------
이 명령은 현재 위치를 기본 스택에 밀어넣은 다음 C:\Windows로 위치를 변경합니다.

예 2

C:\PS>push-location HKLM:\Software\Policies -stackname RegFunction

설명
-----------
이 명령은 현재 위치를 RegFunction 스택에 밀어넣은 다음 HKLM:\Software\Policies로 위치로 변경합니다. 이 명령은 Push-Location을 Windows PowerShell 레지스트리 공급자와 함께 사용할 수 있음을 보여 줍니다.

예 3

C:\PS>push-location

설명
-----------
이 명령은 현재 위치를 기본 스택에 밀어넣습니다.

예 4

C:\PS>push-location ~ -stackname Stack2

설명
-----------
이 명령은 현재 위치를 Stack2라는 새 스택에 밀어넣은 다음 홈 디렉터리(%USERPROFILE%)로 변경합니다. 홈 디렉터리는 이 명령에서 물결표 기호(~) 또는 $home으로 표시되어 있습니다. 그러면 Stack2 스택이 현재 스택이 됩니다.

참고 항목



목차