New-PSDrive
임시 및 영구 매핑된 네트워크 드라이브를 만듭니다.
구문
New-PSDrive
[-Name] <String>
[-PSProvider] <String>
[-Root] <String>
[-Description <String>]
[-Scope <String>]
[-Persist]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]Description
New-PSDrive cmdlet은 네트워크 드라이브, 로컬 컴퓨터의 디렉터리 또는 레지스트리 키, 원격 컴퓨터의 파일 시스템 위치와 연결된 영구 Windows 매핑된 네트워크 드라이브와 같이 데이터 저장소의 위치에 매핑되거나 연결된 임시 및 영구 드라이브를 만듭니다.
임시 드라이브는 현재 PowerShell 세션 및 현재 세션에서 만든 세션에만 존재합니다.
PowerShell에서 유효한 이름을 가질 수 있으며 로컬 또는 원격 리소스에 매핑할 수 있습니다.
매핑된 네트워크 드라이브와 마찬가지로 임시 PowerShell 드라이브를 사용하여 연결된 데이터 저장소의 데이터에 액세스할 수 있습니다.
그러나 임시 드라이브는 PowerShell에만 알려져 있으므로 파일 탐색기, WMI(Windows Management Instrumentation), COM(구성 요소 개체 모델) 또는 Microsoft .NET Framework를 사용하거나 Net Use와 같은 도구를 사용하여 액세스할 수 없습니다.
Windows PowerShell 3.0의 New-PSDrive 다음 기능이 추가됩니다.
- 매핑된 네트워크 드라이브.
New-PSDrivePersist 매개 변수를 사용하여 Windows 매핑된 네트워크 드라이브를 만들 수 있습니다. 임시 PowerShell 드라이브와 달리 Windows 매핑된 네트워크 드라이브는 세션별 드라이브가 아닙니다. Windows에 저장되며 파일 탐색기 및 Net Use와 같은 표준 Windows 도구를 사용하여 관리할 수 있습니다. 매핑된 네트워크 드라이브에는 드라이브 문자 이름이 있어야 하며 원격 파일 시스템 위치에 연결되어야 합니다. 명령의 범위가 로컬로 지정되면(점 소싱 없음) Persist 매개 변수는 명령이 실행되는 범위를 벗어나는 PSDrive 생성을 유지하지 않습니다. 스크립트 내에서New-PSDrive실행하고 드라이브가 무기한 유지되도록 하려면 스크립트의 원본을 지정해야 합니다. 최상의 결과를 얻으려면 새 드라이브가 무기한 유지되도록 하려면 Scope 매개 변수를 명령에 추가하고 해당 값을 Global로 설정합니다. - 외부 드라이브. 외부 드라이브가 컴퓨터에 연결되면 PowerShell은 새 드라이브를 나타내는 파일 시스템에 PSDrive 자동으로 추가합니다. PowerShell을 다시 시작할 필요가 없습니다. 마찬가지로, 컴퓨터에서 외부 드라이브의 연결이 끊어지면 PowerShell은 제거된 드라이브를 나타내는 PSDrive 자동으로 삭제합니다.
- UNC 경로에 대한 자격 증명입니다.
Root 매개 변수의 값이 UNC 경로(예: \\Server\Share)인 경우 자격 증명 매개 변수 값에 지정된 자격 증명을 사용하여 PSDrive만듭니다. 그렇지 않으면 자격 증명 새 파일 시스템 드라이브를 만들 때 유효하지 않습니다.
예제
예제 1: 네트워크 공유에 매핑된 드라이브 만들기
New-PSDrive -Name "P" -PSProvider "FileSystem" -Root "\\Server01\Public"
Name Provider Root
---- -------- ----
P FileSystem \\Server01\Public이 명령은 \\Server01\Public 네트워크 공유에 매핑되는 P라는 임시 PowerShell 드라이브를 만듭니다.
Name 매개 변수를 사용하여 드라이브의 이름, PSProvider 매개 변수를 사용하여 PowerShell FileSystem 공급자를 지정하고 Root 매개 변수를 사용하여 네트워크 공유를 지정합니다.
명령이 완료되면 \\Server01\Public 공유의 내용이 P: 드라이브에 표시됩니다.
이를 보려면 다음을 입력합니다. dir P:.
예제 2: 임시 드라이브 만들기
New-PSDrive -Name MyDocs -PSProvider FileSystem -Root "C:\Documents and Settings\User01\My Documents" -Description "Maps to my My Documents folder."
Name Provider Root
---- -------- ----
MyDocs FileSystem C:\Documents and Settings\User01\My Documents이 명령은 로컬 디렉터리에 대한 빠른 액세스를 제공하는 임시 PowerShell 드라이브를 만듭니다. 로컬 컴퓨터의 "C:\Documents and Settings\User01\My Documents" 디렉터리에 매핑되는 MyDocs라는 드라이브를 만듭니다.
명령이 완료되면 내 문서 폴더의 내용이 MyDocs: 드라이브에 표시됩니다.
이를 보려면 다음을 입력합니다. dir MyDocs:.
예제 3: 레지스트리 키에 대한 드라이브 만들기
New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"
Name Provider Root
---- -------- ----
MyCompany Registry HKEY_LOCAL_MACHINE\Software\MyCo...이 명령은 자주 확인되는 레지스트리 키에 대한 빠른 액세스를 제공하는 임시 PowerShell 드라이브를 만듭니다.
HKLM\Software\MyCompany 레지스트리 키에 매핑되는 MyCompany라는 드라이브를 만듭니다.
명령이 완료되면 MyCompany 키의 내용이 MyCompany: 드라이브에 표시됩니다.
이를 보려면 다음을 입력합니다. dir MyCompany:.
예제 4: 지속형 매핑된 네트워크 드라이브 만들기
New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem"
Net Use
Status Local Remote Network
---------------------------------------------------------
OK S: \\Server01\Scripts Microsoft Windows Network이 명령은 로컬 컴퓨터에 'S' 매핑된 네트워크 드라이브를 만듭니다. 'S' 드라이브는 \\Server01\Scripts 네트워크 공유에 매핑됩니다.
이 명령은 New-PSDrive 사용하여 매핑된 네트워크 드라이브를 만듭니다.
지속 사용하여 로컬 컴퓨터에 저장된 Windows 매핑된 네트워크 드라이브를 만듭니다.
이 명령은
결과 드라이브는 로컬 컴퓨터의 다른 PowerShell 세션, Windows 탐색기 및 Net Use와 같은 다른 도구에서 볼 수 있습니다.
예제 5: 영구 및 임시 드라이브 만들기
# Create a temporary PowerShell drive called PSDrive: that is mapped to the \\Server01\Public network share.
New-PSDrive -Name "PSDrive" -PSProvider "FileSystem" -Root "\\Server01\Public"
# Use the *Persist* parameter of **New-PSDrive** to create the X: mapped network drive, which is also mapped to the \\Server01\Public network share.
New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public"
# Now, you can use the **Get-PSDrive** drive cmdlet to examine the two drives. The drives appear to be the same, although the network share name appears only in the root of the PSDrive: drive.
Get-PSDrive -Name "PSDrive", "X"
Name Provider Root
---- -------- ----
PsDrive FileSystem \\Server01\public
X FileSystem X:\
# Get-Member cmdlet shows that the drives have the same object type, System.Management.Automation.PSDriveInfo.
Get-PSDrive "PSDrive", "x" | Get-Member
TypeName: System.Management.Automation.PSDriveInfo
Name MemberType Definition
---- ---------- ----------
CompareTo Method System.Int32 CompareTo(PSDriveInfo drive),
Equals Method System.Boolean Equals(Object obj),
GetHashCode Method System.Int32 GetHashCode()
...
# Net Use and Get-WmiObject for the Win32_LogicalDisk class, and Win32_NetworkConnection class find only the persistent X: drive.
# PowerShell temporary drives are known only to PowerShell.
Net Use
Get-WmiObject Win32_LogicalDisk | Format-Table -Property DeviceID
Get-WmiObject Win32_NetworkConnection
Status Local Remote Network
--------------------------------------------------------
OK X: \\contoso-pc\data Microsoft Windows Network
deviceid
--------
C:
D:
X:
LocalName RemoteName ConnectionState Status
--------- ---------- --------------- ------
X: \\products\public Disconnected Unavailable이 예제에서는 영구 매핑된 네트워크 드라이브와 동일한 네트워크 공유에 매핑된 임시 PowerShell 드라이브 간의 차이점을 보여 있습니다.
PowerShell 세션을 닫은 다음 새 세션을 열면 PSDrive: 드라이브가 사라지고 X: 드라이브가 유지됩니다. 따라서 네트워크 드라이브를 매핑하는 데 사용할 방법을 결정할 때 드라이브를 사용하는 방법, 드라이브를 영구적이어야 하는지 여부 및 드라이브를 다른 Windows 기능에 표시해야 하는지 여부를 고려합니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
이 작업을 수행할 수 있는 권한이 있는 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다.
"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 생성된 개체와 같은 PSCredential 개체를 입력합니다.
사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.
Windows PowerShell 3.0부터 Root 매개 변수의 값이 UNC 경로인 경우 자격 증명을 사용하여 파일 시스템 드라이브를 만들 수 있습니다. 이 매개 변수는 모든 PowerShell 공급자에서 지원되지 않습니다.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Description
드라이브에 대한 간단한 텍스트 설명을 지정합니다. 문자열을 입력합니다.
세션의 모든 드라이브에 대한 설명을 보려면 Get-PSDrive | Format-Table Name, Description입력합니다.
특정 드라이브에 대한 설명을 보려면 (Get-PSDrive \<DriveName\>).Description입력합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
새 드라이브의 이름을 지정합니다. 영구 매핑된 네트워크 드라이브의 경우 드라이브 문자를 입력합니다. 임시 PowerShell 드라이브의 경우 유효한 문자열을 입력합니다. 드라이브 문자로 제한되지 않습니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Persist
이 cmdlet은 Windows 매핑된 네트워크 드라이브를 만듭니다. 매핑된 네트워크 드라이브는 로컬 컴퓨터의 Windows에 저장됩니다. 세션별이 아닌 영구적이며 파일 탐색기 및 기타 도구에서 보고 관리할 수 있습니다.
명령의 범위를 로컬로 지정하는 경우, 즉 점 소싱 없이 Persist 매개 변수는 명령을 실행하는 범위를 벗어나는 PSDrive 생성을 유지하지 않습니다.
스크립트 내에서 New-PSDrive 실행하고 새 드라이브가 무기한 유지되도록 하려면 스크립트의 원본을 지정해야 합니다.
최상의 결과를 얻으려면 새 드라이브가 강제로 유지되도록 하려면 명령에 지속 추가하는 것 외에도 Scope 매개 변수의 값으로 Global을 지정합니다.
드라이브 이름은 'D' 또는 'E'와 같은 문자여야 합니다. Root 매개 변수의 값은 다른 컴퓨터의 UNC 경로여야 합니다. PSProvider 매개 변수의 값은 FileSystem이어야 합니다.
Windows 매핑된 네트워크 드라이브의 연결을 끊려면 Remove-PSDrive cmdlet을 사용합니다.
Windows 매핑된 네트워크 드라이브의 연결을 끊으면 매핑이 현재 세션에서 삭제되는 것이 아니라 컴퓨터에서 영구적으로 삭제됩니다.
매핑된 네트워크 드라이브는 사용자 계정과 관련이 있습니다. 다른 사용자의 자격 증명을 사용하여 관리자 권한 세션 또는 세션에서 만든 매핑된 드라이브는 다른 자격 증명을 사용하여 시작된 세션에서 표시되지 않습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PSProvider
이러한 종류의 드라이브를 지원하는 PowerShell 공급자를 지정합니다.
예를 들어 드라이브가 네트워크 공유 또는 파일 시스템 디렉터리에 연결된 경우 PowerShell 공급자는 FileSystem입니다. 드라이브가 레지스트리 키와 연결된 경우 공급자는 레지스트리입니다.
임시 PowerShell 드라이브는 모든 PowerShell 공급자와 연결할 수 있습니다. 매핑된 네트워크 드라이브는 FileSystem 공급자와만 연결할 수 있습니다.
PowerShell 세션에서 공급자 목록을 보려면 Get-PSProvider cmdlet을 사용합니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Root
PowerShell 드라이브가 매핑되는 데이터 저장소 위치를 지정합니다.
예를 들어 \\Server01\Public과 같은 네트워크 공유, C:\Program Files와 같은 로컬 디렉터리 또는 HKLM:\Software\Microsoft와 같은 레지스트리 키를 지정합니다.
임시 PowerShell 드라이브는 지원되는 공급자 드라이브의 로컬 또는 원격 위치와 연결할 수 있습니다. 매핑된 네트워크 드라이브는 원격 컴퓨터의 파일 시스템 위치에만 연결할 수 있습니다.
| 형식: | String |
| Position: | 2 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Scope
드라이브의 범위를 지정합니다. 이 매개 변수에 허용되는 값은 전역, 로컬 및 스크립트이거나 현재 범위에 상대적인 숫자입니다. 범위 수를 통해 0의 범위를 지정합니다. 현재 범위 번호는 0이고 부모는 1입니다. 자세한 내용은 about_Scopes참조하세요.
| 형식: | String |
| Position: | Named |
| Default value: | Local |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-UseTransaction
활성 트랜잭션에 명령을 포함합니다. 이 매개 변수는 트랜잭션이 진행 중인 경우에만 유효합니다. 자세한 내용은 about_Transactions참조하세요.
| 형식: | SwitchParameter |
| 별칭: | usetx |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
이 cmdlet에 입력을 파이프할 수 없습니다.
출력
참고
-
New-PSDrive공급자가 노출하는 데이터를 사용하도록 설계되었습니다. 세션에서 사용할 수 있는 공급자를 나열하려면Get-PSProvider사용합니다. 공급자에 대한 자세한 내용은 about_Providers참조하세요. - 매핑된 네트워크 드라이브는 사용자 계정과 관련이 있습니다. 다른 사용자의 자격 증명을 사용하여 관리자 권한 세션 또는 세션에서 만든 매핑된 드라이브는 다른 자격 증명을 사용하여 시작된 세션에서 표시되지 않습니다.