New-PSDrive

Modul:

Microsoft.PowerShell.Management Module

Ideiglenes és állandó meghajtókat hoz létre, amelyek egy elem adattárában lévő helyhez vannak társítva.

Syntax

All

New-PSDrive
    [-Name] <String>
    [-PSProvider] <String>
    [-Root] <String>
    [-Description <String>]
    [-Scope <String>]
    [-Persist]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

A New-PSDrive parancsmag ideiglenes és állandó meghajtókat hoz létre, amelyek egy adattár helyéhez vannak hozzárendelve, vagy azokhoz vannak társítva, például hálózati meghajtót, a helyi számítógépen található könyvtárat vagy egy beállításkulcsot, valamint egy távoli számítógépen található fájlrendszer-helyhez társított állandó Windows-megfeleltetett hálózati meghajtókat.

Az ideiglenes meghajtók csak az aktuális PowerShell-munkamenetben és az aktuális munkamenetben létrehozott munkamenetekben léteznek. Bármilyen, a PowerShellben érvényes névvel rendelkezhetnek, és bármely helyi vagy távoli erőforráshoz leképezhetők. Ideiglenes PowerShell-meghajtók használatával is hozzáférhet a társított adattár adataihoz, ugyanúgy, mint bármely leképezett hálózati meghajtó esetén. A meghajtó helyét a Set-Locationhasználatával módosíthatja, és Get-Item vagy Get-ChildItemhasználatával érheti el a meghajtó tartalmát.

Mivel az ideiglenes meghajtókat csak a PowerShell ismeri, a Fájlkezelő, a Windows Management Instrumentation (WMI), a komponensobjektum-modell (COM), a Microsoft .NET-keretrendszer vagy az olyan eszközök használatával, mint a net use.

A PowerShell 3.0-ban a következő funkciók lettek hozzáadva New-PSDrive:

• Leképezett hálózati meghajtók. A New-PSDrive paraméterével windowsos hálózati meghajtókat hozhat létre. Az ideiglenes PowerShell-meghajtókkal ellentétben a Windows-megfeleltetett hálózati meghajtók nem munkamenet-specifikusak. Windows rendszerben vannak mentve, és kezelhetők szabványos Windows-eszközökkel, például a Fájlkezelővel és net use. A leképezett hálózati meghajtóknak meghajtóbetűjellel kell rendelkezniük, és távoli fájlrendszer-helyhez kell csatlakozniuk. Ha a parancs hatóköre helyileg van korlátozva, nincs dot-sourcing, a Persist paraméter nem tartja meg a PSDrive létrehozását azon a hatókörön túl, amelyben a parancs fut. Ha New-PSDrive futtat egy szkripten belül, és azt szeretné, hogy a meghajtó határozatlan ideig megmaradjon, akkor pontforrásként kell használnia a szkriptet. A legjobb eredmény érdekében, ha egy új meghajtó határozatlan ideig történő megőrzésére szeretné kényszeríteni, adja hozzá a Hatókör paramétert a parancshoz, és állítsa az értékét globális. További információ a dot-sourcingról: about_Scripts.
• Külső meghajtók. Ha egy külső meghajtó csatlakozik a számítógéphez, a PowerShell automatikusan hozzáad egy PSDrive- az új meghajtót képviselő fájlrendszerhez. Nem kell újraindítania a PowerShellt. Hasonlóképpen, ha egy külső meghajtót leválasztanak a számítógépről, a PowerShell automatikusan törli az eltávolított meghajtót jelképező PSDrive.
• Hitelesítő adatok az univerzális elnevezési konvenció (UNC) elérési útjaihoz.

Ha a Gyökér paraméter értéke UNC elérési út ( például \\Server\Share), a rendszer a Hitelesítő adatok paraméter értékében megadott hitelesítő adatot használja a PSDrivelétrehozásához. Ellenkező esetben hitelesítő adatok nem hatékonyak új fájlrendszer-meghajtók létrehozásakor.

Egyes kódminták splatting használatával csökkentik a vonal hosszát és javítják az olvashatóságot. További információkért tekintse meg a következőket: about_Splatting.

Megjegyzés:

Ha nem használja a Hatókör paramétert, a PSDrive-k abban a hatókörben jönnek létre, amelyben a New-PSDrive parancs fut.

Példák

1. példa: Hálózati megosztáshoz hozzárendelt ideiglenes meghajtó létrehozása

Ez a példa létrehoz egy ideiglenes PowerShell-meghajtót, amely egy hálózati megosztáshoz van leképezve.

New-PSDrive -Name "Public" -PSProvider "FileSystem" -Root "\\Server01\Public"

Name       Provider      Root
----       --------      ----
Public     FileSystem    \\Server01\Public

New-PSDrive a Név paraméter használatával adja meg a Public nevű PowerShell-meghajtót, a PSProvider paramétert a PowerShell-FileSystem-szolgáltató megadásához. A root paraméter határozza meg a hálózati megosztás UNC elérési útját.

PowerShell-munkamenet tartalmainak megtekintése: Get-ChildItem -Path Public:

2. példa: Helyi könyvtárhoz hozzárendelt ideiglenes meghajtó létrehozása

Ez a példa létrehoz egy ideiglenes PowerShell-meghajtót, amely hozzáférést biztosít a helyi számítógépen található könyvtárhoz.

$parameters = @{
    Name = "MyDocs"
    PSProvider = "FileSystem"
    Root = "C:\Users\User01\Documents"
    Description = "Maps to my My Documents folder."
}
New-PSDrive @parameters

Name        Provider      Root
----        --------      ----
MyDocs      FileSystem    C:\Users\User01\Documents

A Splatting létrehozza a paraméterkulcsokat és -értékeket. A Name paraméter adja meg a meghajtó nevét, MyDocs. A PSProvider paraméter határozza meg a PowerShell-FileSystem szolgáltatót. gyökér a helyi számítógép könyvtárát adja meg. A Description paraméter a meghajtó célját írja le. New-PSDrive a kiszúrt paraméterekkel hozza létre a MyDocs meghajtót.

PowerShell-munkamenet tartalmainak megtekintése: Get-ChildItem -Path MyDocs:

3. példa: Ideiglenes meghajtó létrehozása beállításkulcshoz

Ez a példa létrehoz egy ideiglenes PowerShell-meghajtót, amely hozzáférést biztosít egy beállításkulcshoz. Létrehoz egy MyCompany nevű meghajtót, amely a HKLM:\Software\MyCompany beállításkulcshoz van hozzárendelve.

New-PSDrive -Name "MyCompany" -PSProvider "Registry" -Root "HKLM:\Software\MyCompany"

Name           Provider      Root
----           --------      ----
MyCompany      Registry      HKLM:\Software\MyCompany

New-PSDrive a Név paraméter használatával adja meg a MyCompany nevű PowerShell-meghajtót, a PSProvider paramétert a PowerShell-Registry-szolgáltató megadásához. A beállításjegyzék helyét a gyökér paraméter határozza meg.

PowerShell-munkamenet tartalmainak megtekintése: Get-ChildItem -Path MyCompany:

4. példa: Állandó leképezett hálózati meghajtó létrehozása hitelesítő adatokkal

Ez a példa egy tartományi szolgáltatásfiók hitelesítő adataival hitelesített hálózati meghajtót képez le. A hitelesítő adatokat tároló PSCredential objektumról, valamint a jelszavak SecureStringként való tárolásáról a Hitelesítő adatok paraméter leírásában talál további információt.

$cred = Get-Credential -Credential Contoso\ServiceAccount
New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem" -Credential $cred
Net Use

Status       Local     Remote                    Network
---------------------------------------------------------
OK           S:        \\Server01\Scripts        Microsoft Windows Network

Megjegyzés:

Ne feledje, hogy ha a fenti kódrészletet egy szkriptben használja, állítsa a Hatókör paraméter értékét "Global" értékre, hogy a meghajtó az aktuális hatókörön kívül maradjon.

A $cred változó egy PSCredential objektumot tárol, amely tartalmazza a szolgáltatásfiók hitelesítő adatait. Get-Credential kéri, hogy adja meg a SecureStringtárolt jelszót.

New-PSDrive több paraméter használatával hozza létre a leképezett hálózati meghajtót. Név a Windows által elfogadott S meghajtóbetűjelet adja meg. és gyökér a távoli számítógépen lévő helyként határozza meg a \\Server01\Scripts. Persist létrehoz egy Windows-megfeleltetett hálózati meghajtót, amely a helyi számítógépen van mentve. PSProvider határozza meg a FileSystem szolgáltatót. Hitelesítő adatok a $cred változó használatával kéri le a szolgáltatásfiók hitelesítő adatait a hitelesítéshez.

A leképezett meghajtó megtekinthető a helyi számítógépen a PowerShell-munkamenetekben, a Fájlkezelőben és olyan eszközökkel, mint net use. PowerShell-munkamenet tartalmainak megtekintése: Get-ChildItem -Path S:

5. példa: Állandó és ideiglenes meghajtók létrehozása

Ez a példa egy állandó leképezett hálózati meghajtó és egy ideiglenes PowerShell-meghajtó közötti különbséget mutatja be, amely ugyanahhoz a hálózati megosztáshoz van leképezve.

Ha bezárja a PowerShell-munkamenetet, majd megnyit egy új munkamenetet, az ideiglenes PSDrive: nem érhető el, de az állandó X: meghajtó elérhető. Amikor eldönti, hogy melyik módszert használja a hálózati meghajtók leképezéséhez, gondolja át, hogyan fogja használni a meghajtót. Például, hogy állandónak kell-e lennie, és hogy a meghajtónak láthatónak kell-e lennie más Windows-funkciók számára.

# Create a temporary PowerShell drive called PSDrive:
# that's 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-CimInstance 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-CimInstance Win32_LogicalDisk | Format-Table -Property DeviceID
Get-CimInstance 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

6. példa: Állandó meghajtó létrehozása szkriptben

A PSDrive-k abban a hatókörben jönnek létre, amelyben a New-PSDrive parancs fut. Ha a parancs egy szkripten belül fut, a meghajtóleképezés helyi a szkripthez. Amikor a szkript kilép, a meghajtó már nem érhető el.

New-PSDrive -Persist -Name "X" -PSProvider "FileSystem" -Root "\\Server01\Public" -Scope Global

Annak biztosításához, hogy a meghajtó a szkripten kívül is elérhető legyen, a Hatókör paraméterrel kell létrehoznia a meghajtót a Globális hatókörben.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Credential

Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Az alapértelmezett az aktuális felhasználó.

Mivel a PowerShell 3.0-s verziójában a root paraméter értéke UNC-elérési út, hitelesítő adatokkal hozhat létre fájlrendszer-meghajtókat.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy adjon meg egy PSCredential objektumot, amelyet a Get-Credential parancsmag generál. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.

A hitelesítő adatokat egy PSCredential objektum tárolja, a jelszó pedig SecureString.

Megjegyzés:

További információért a SecureString adatvédelemről lásd: Mennyire biztonságos a SecureString?.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	Current user
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Description

A meghajtó rövid szöveges leírását adja meg. Írjon be bármilyen sztringet.

Az összes munkamenet-meghajtó leírásának megtekintéséhez Get-PSDrive | Format-Table Name, Description.

Egy adott meghajtó leírásának megtekintéséhez írja be a (Get-PSDrive <DriveName>).Description.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

Megadja az új meghajtó nevét. Állandó leképezett hálózati meghajtók esetén használjon meghajtóbetűjelet. Az ideiglenes PowerShell-meghajtók esetében nem korlátozódik a meghajtóbetűjelekre, használjon érvényes sztringet.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Persist

Azt jelzi, hogy ez a parancsmag létrehoz egy Windows-megfeleltetett hálózati meghajtót. A Persist paraméter csak Windows rendszeren érhető el.

A leképezett hálózati meghajtókat a rendszer windowsos környezetben menti a helyi számítógépen. Állandóak, nem munkamenet-specifikusak, és megtekinthetők és kezelhetők a Fájlkezelőben és más eszközökben.

Ha a parancsot helyileg, pont-forráskezelés nélkül hatókörbe veszi, a Persist paraméter nem tartja meg a PSDrive- létrehozását azon a hatókörön túl, amelyben a parancsot futtatja. Ha New-PSDrive futtat egy szkripten belül, és azt szeretné, hogy az új meghajtó határozatlan ideig megmaradjon, akkor pontforrásként kell használnia a szkriptet. A legjobb eredmény érdekében egy új meghajtó megőrzésének kényszerítéséhez adja meg globális a Hatókör paraméter értékeként, és adja meg megőrzése parancsot.

A meghajtó nevének betűnek kell lennie, például D vagy E. A root paraméter értékének egy másik számítógép UNC elérési útjának kell lennie. A PSProvider paraméter értékének FileSystemkell lennie.

Windows-megfeleltetett hálózati meghajtó leválasztásához használja a Remove-PSDrive parancsmagot. Ha leválaszt egy Windows-megfeleltetett hálózati meghajtót, a leképezés véglegesen törlődik a számítógépről, nem csak az aktuális munkamenetből.

A leképezett hálózati meghajtók egy felhasználói fiókra vonatkoznak. Az emelt szintű munkamenetekben vagy munkamenetekben egy másik felhasználó hitelesítő adataival létrehozott leképezett meghajtók nem láthatók a különböző hitelesítő adatokkal indított munkamenetekben.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-PSProvider

Megadja az ilyen típusú meghajtókat támogató PowerShell-szolgáltatót.

Ha például a meghajtó hálózati megosztáshoz vagy fájlrendszer-címtárhoz van társítva, a PowerShell-szolgáltató FileSystem. Ha a meghajtó egy beállításkulcshoz van társítva, a szolgáltató Registry.

Az ideiglenes PowerShell-meghajtók bármely PowerShell-szolgáltatóhoz társíthatók. A leképezett hálózati meghajtók csak a FileSystem szolgáltatóhoz társíthatók.

A PowerShell-munkamenetben lévő szolgáltatók listájának megtekintéséhez használja a Get-PSProvider parancsmagot.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Root

Megadja az adattár helyét, amelyre a PowerShell-meghajtó le van képezve.

Megadhat például egy hálózati megosztást, például \\Server01\Public, helyi könyvtárat, például C:\Program Filesvagy beállításkulcsot, például HKLM:\Software\Microsoft.

Az ideiglenes PowerShell-meghajtók bármely támogatott szolgáltatói meghajtón helyi vagy távoli helyhez társíthatók. A leképezett hálózati meghajtók csak távoli számítógépen lévő fájlrendszer-helyhez társíthatók.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	2
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Scope

A meghajtó hatókörét adja meg. A paraméter elfogadható értékei a következők: Globális, Helyiés Szkript, vagy az aktuális hatókörhöz viszonyított szám. A hatókörök száma 0 a hatókörök számán keresztül. Az aktuális hatókör száma 0, szülője pedig 1. További információ található a about_Scopesrészben.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	Local
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Nem lehet objektumokat csövezni ehhez a parancsmaghoz

Kimenetek

PSDriveInfo

Ez a parancsmag egy PSDriveInfo objektumot ad vissza, amely a létrehozott meghajtót jelöli.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Get-PSDrive:

• Minden platform:
  • ndr
• Windows:
  • mount

New-PSDrive úgy tervezték, hogy bármely szolgáltató által közzétett adatokkal működjön együtt. A munkamenetben elérhető szolgáltatók listájához használja a Get-PSProvider. További információ a szolgáltatókról: about_Providers.

A leképezett hálózati meghajtók egy felhasználói fiókra vonatkoznak. Az emelt szintű munkamenetekben vagy munkamenetekben egy másik felhasználó hitelesítő adataival létrehozott leképezett meghajtók nem láthatók a különböző hitelesítő adatokkal indított munkamenetekben.

Kapcsolódó hivatkozások

• A szolgáltatókról
• Get-Credential
• Get-PSDrive
• Remove-PSDrive