New-PSDrive

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

Polecenie cmdlet New-PSDrive tworzy tymczasowe i trwałe dyski, które są mapowane na lub skojarzone z lokalizacją w magazynie danych, takim jak dysk sieciowy, katalog na komputerze lokalnym lub klucz rejestru oraz trwałe dyski sieciowe mapowane przez system Windows skojarzone z lokalizacją systemu plików na komputerze zdalnym.

Dyski tymczasowe istnieją tylko w bieżącej sesji programu PowerShell i w sesjach utworzonych w bieżącej sesji. Mogą mieć dowolną nazwę prawidłową w programie PowerShell i mogą być mapowane na dowolny zasób lokalny lub zdalny. Możesz użyć tymczasowych dysków programu PowerShell, aby uzyskać dostęp do danych w skojarzonym magazynie danych, podobnie jak w przypadku dowolnego zamapowanego dysku sieciowego. Lokalizacje można zmienić na dysk przy użyciu Set-Location, cdlub chdiri uzyskać dostęp do zawartości dysku przy użyciu Get-Item, Get-ChildItemlub dir.

Jednak ze względu na to, że dyski tymczasowe są znane tylko programowi PowerShell, nie można uzyskać do nich dostępu przy użyciu Eksploratora plików, Instrumentacji zarządzania Windows (WMI), modelu obiektów składników (COM) lub programu Microsoft .NET Framework lub przy użyciu narzędzi takich jak Net Use.

Następujące funkcje są dodawane do New-PSDrive w programie Windows PowerShell 3.0:

• Zamapowane dyski sieciowe. Aby utworzyć zamapowane dyski sieciowe systemu Windows, można użyć parametru PersistNew-PSDrive. W przeciwieństwie do tymczasowych dysków programu PowerShell, zamapowane dyski sieciowe systemu Windows nie są specyficzne dla sesji. Są one zapisywane w systemie Windows i mogą być zarządzane przy użyciu standardowych narzędzi systemu Windows, takich jak Eksplorator plików i Net Use. Zamapowane dyski sieciowe muszą mieć nazwę litery dysku i być podłączone do zdalnej lokalizacji systemu plików. Gdy polecenie jest ograniczone lokalnie (bez określania wartości kropkowej), parametr Persist nie utrwala tworzenia PSDrive poza zakresem, w którym jest uruchomione polecenie. Jeśli uruchamiasz New-PSDrive wewnątrz skryptu i chcesz, aby dysk był trwały w nieskończoność, musisz umieścić skrypt dot-source. Aby uzyskać najlepsze wyniki, aby wymusić utrwalanie nowego dysku na czas nieokreślony, dodaj parametr zakresu do polecenia i ustaw jego wartość na Global.
• Dyski zewnętrzne. Gdy dysk zewnętrzny jest połączony z komputerem, program PowerShell automatycznie dodaje PSDrive do systemu plików reprezentującego nowy dysk. Nie trzeba ponownie uruchamiać programu PowerShell. Podobnie, gdy dysk zewnętrzny zostanie odłączony od komputera, program PowerShell automatycznie usunie PSDrive, który reprezentuje usunięty dysk.
• Poświadczenia dla ścieżek UNC.

Gdy wartość parametru głównego jest ścieżką UNC, taką jak \\Server\Share, poświadczenie określone w wartości parametru Credential służy do tworzenia PSDrive. W przeciwnym razie poświadczenie nie jest skuteczne podczas tworzenia nowych dysków systemu plików.

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

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

To polecenie tworzy tymczasowy dysk programu PowerShell o nazwie P: który jest mapowany na udział sieci \\Server01\Public.

Używa parametru Name do określenia nazwy dysku, parametru PSProvider w celu określenia dostawcy systemu plików programu PowerShell oraz parametru Root w celu określenia udziału sieciowego.

Po zakończeniu polecenia zawartość udziału \\Server01\Public pojawi się na dysku P: . Aby je wyświetlić, wpisz: dir P:.

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

To polecenie tworzy tymczasowy dysk programu PowerShell, który zapewnia szybki dostęp do katalogu lokalnego. Tworzy dysk o nazwie MyDocs: jest mapowany na katalog "C:\Documents and Settings\User01\My Documents" na komputerze lokalnym.

Używa Nazwa, aby określić nazwę dysku, PSProvider określić dostawcę systemu plików programu PowerShell, główny określić ścieżkę folderu Moje dokumenty oraz parametr Opis w celu utworzenia opisu dysku.

Po zakończeniu polecenia zawartość folderu Moje dokumenty zostanie wyświetlona na dysku MyDocs:. Aby je wyświetlić, wpisz: dir MyDocs:.

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

Name       Provider      Root
----       --------      ----
MyCompany  Registry      HKEY_LOCAL_MACHINE\Software\MyCo...

To polecenie tworzy tymczasowy dysk programu PowerShell, który zapewnia szybki dostęp do często sprawdzanego klucza rejestru. Tworzy dysk o nazwie MyCompany zamapowany na klucz rejestru HKLM\Software\MyCompany.

Używa Nazwa, aby określić nazwę dysku, PSProvider określić dostawcę rejestru programu PowerShell i root określić klucz rejestru.

Po zakończeniu polecenia zawartość klucza MyCompany zostanie wyświetlona na dysku MyCompany:. Aby je wyświetlić, wpisz: dir MyCompany:.

New-PSDrive -Name "S" -Root "\\Server01\Scripts" -Persist -PSProvider "FileSystem"
Net Use

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

To polecenie tworzy zamapowany dysk sieciowy "S" na komputerze lokalnym. Dysk "S" jest mapowany na udział sieciowy \\Server01\Scripts.

Polecenie używa New-PSDrive do utworzenia zamapowanego dysku sieciowego. Używa on Persist do utworzenia zamapowanego dysku sieciowego systemu Windows zapisanego na komputerze lokalnym.

Polecenie używa Nazwa, aby określić nazwę litery akceptowaną przez system Windows i root w celu określenia lokalizacji na komputerze zdalnym. Używa PSProvider do określenia dostawcy systemu plików.

Wynikowy dysk można wyświetlić w innych sesjach programu PowerShell na komputerze lokalnym, w Eksploratorze Windows i w innych narzędziach, takich jak Net Use.

# 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

W tym przykładzie pokazano różnicę między trwałym mapowanym dyskiem sieciowym a tymczasowym dyskiem programu PowerShell zamapowanym na ten sam udział sieciowy.

Jeśli zamkniesz sesję programu PowerShell, a następnie otworzysz nową, dysk PSDrive: zniknął, a dysk X: będzie się powtarzać. W związku z tym podczas podejmowania decyzji, która metoda ma być używana do mapowania dysków sieciowych, należy wziąć pod uwagę sposób używania dysku, czy musi być trwały i czy dysk musi być widoczny dla innych funkcji systemu Windows.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

• New-PSDrive jest przeznaczona do pracy z danymi udostępnianymi przez dowolnego dostawcę. Aby wyświetlić listę dostawców dostępnych w sesji, użyj Get-PSProvider. Aby uzyskać więcej informacji na temat dostawców, zobacz about_Providers.
• Zamapowane dyski sieciowe są specyficzne dla konta użytkownika. Zamapowane dyski utworzone w sesjach z podwyższonym poziomem uprawnień lub sesjach przy użyciu poświadczeń innego użytkownika nie są widoczne w sesjach rozpoczętych przy użyciu różnych poświadczeń.