Подключить сетевой диск Powershell
Обновлено: 21.11.2024
Создает временные и постоянные диски, связанные с местоположением в хранилище данных элементов.
Синтаксис
Описание
Командлет New-PSDrive создает временные и постоянные диски, которые сопоставляются с расположением в хранилище данных или связаны с ним, например сетевой диск, каталог на локальном компьютере или раздел реестра, а также постоянная сопоставленная сеть Windows. диски, связанные с расположением файловой системы на удаленном компьютере.
Временные диски существуют только в текущем сеансе PowerShell и в сеансах, которые вы создаете в текущем сеансе. Они могут иметь любое имя, допустимое в PowerShell, и могут быть сопоставлены с любым локальным или удаленным ресурсом. Вы можете использовать временные диски PowerShell для доступа к данным в связанном хранилище данных точно так же, как и с любым подключенным сетевым диском. Вы можете изменить местоположение на диске с помощью Set-Location и получить доступ к содержимому диска с помощью Get-Item или Get-ChildItem .
Следующие функции были добавлены в New-PSDrive в PowerShell 3.0:
- Подключенные сетевые диски. Вы можете использовать параметр Persist команды New-PSDrive для создания подключенных сетевых дисков Windows. В отличие от временных дисков PowerShell, подключенные сетевые диски Windows не зависят от сеанса. Они сохраняются в Windows, и ими можно управлять с помощью стандартных инструментов Windows, таких как проводник и сетевое использование. Подключенные сетевые диски должны иметь буквенное имя диска и быть подключены к удаленному расположению файловой системы. Когда ваша команда имеет локальную область действия, без точечного источника, параметр Persist не сохраняет создание PSDrive за пределами области, в которой выполняется команда. Если вы запускаете New-PSDrive внутри скрипта и хотите, чтобы диск сохранялся бесконечно долго, вы должны использовать точечный источник скрипта. Для достижения наилучших результатов, чтобы принудительно сохранить новый диск на неопределенный срок, добавьте в команду параметр Scope и установите для него значение Global. Дополнительную информацию о точечном поиске см. в разделе about_Scripts.
- Внешние диски. Когда внешний диск подключается к компьютеру, PowerShell автоматически добавляет PSDrive в файловую систему, представляющую новый диск. Вам не нужно перезапускать PowerShell. Точно так же, когда внешний диск отключается от компьютера, PowerShell автоматически удаляет PSDrive, представляющий удаленный диск.
- Учетные данные для путей универсального соглашения об именах (UNC).
Если значением параметра Root является путь UNC, например \\Server\Share , учетные данные, указанные в значении параметра Credential, используются для создания PSDrive. В противном случае Credential не действует при создании новых дисков файловой системы.
В некоторых примерах кода используется разбрызгивание, чтобы уменьшить длину строки и улучшить читаемость. Дополнительную информацию см. в разделе about_Splatting.
Если вы не используете параметр Scope, PSDrive создаются в той области, в которой выполняется команда New-PSDrive.
Примеры
Пример 1. Создание временного диска, подключенного к общему сетевому ресурсу
В этом примере создается временный диск PowerShell, сопоставленный с сетевым ресурсом.
Командлет New-PSDrive использует параметр Name для указания диска PowerShell с именем Public и параметр PSProvider для указания поставщика файловой системы PowerShell. Параметр Root указывает путь UNC к общему сетевому ресурсу.
Чтобы просмотреть содержимое сеанса PowerShell: Get-ChildItem -Path Public:
Пример 2. Создание временного диска, сопоставленного с локальным каталогом
В этом примере создается временный диск PowerShell, обеспечивающий доступ к каталогу на локальном компьютере.
Splatting создает ключи и значения параметров. Параметр Name указывает имя диска MyDocs. Параметр PSProvider указывает поставщика файловой системы PowerShell. Корень указывает каталог локального компьютера. Параметр Description описывает назначение привода. New-PSDrive использует заданные параметры для создания диска MyDocs.
Чтобы просмотреть содержимое сеанса PowerShell: Get-ChildItem -Path MyDocs:
Пример 3. Создание временного диска для раздела реестра
В этом примере создается временный диск PowerShell, предоставляющий доступ к разделу реестра. Он создает диск с именем MyCompany, который сопоставляется с разделом реестра HKLM:\Software\MyCompany.
Командлет New-PSDrive использует параметр Name для указания диска PowerShell с именем MyCompany и параметр PSProvider для указания поставщика реестра PowerShell. Параметр Root указывает расположение реестра.
Чтобы просмотреть содержимое сеанса PowerShell: Get-ChildItem -Path MyCompany:
Пример 4. Создание постоянного подключенного сетевого диска с использованием учетных данных
В этом примере подключается сетевой диск, аутентифицированный с использованием учетных данных учетной записи службы домена.Дополнительные сведения об объекте PSCredential, в котором хранятся учетные данные, и о том, как пароли хранятся в виде SecureString, см. в описании параметра Credential.
Помните, что если вы используете приведенный выше фрагмент в сценарии, установите для параметра Scope значение "Global", чтобы диск оставался за пределами текущей области.
Переменная $cred хранит объект PSCredential, содержащий учетные данные сервисного аккаунта. Get-Credential предложит вам ввести пароль, который хранится в SecureString.
Командлет New-PSDrive создает подключенный сетевой диск с использованием нескольких параметров. Имя указывает букву диска S, которую принимает Windows. и Root определяет \\Server01\Scripts как местоположение на удаленном компьютере. Persist создает подключенный сетевой диск Windows, который сохраняется на локальном компьютере. PSProvider указывает поставщика файловой системы. Credential использует переменную $cred для получения учетных данных сервисного аккаунта для аутентификации.
Подключенный диск можно просмотреть на локальном компьютере в сеансах PowerShell, Проводнике и с помощью таких инструментов, как использование сети. Чтобы просмотреть содержимое сеанса PowerShell: Get-ChildItem -Path S:
Пример 5. Создание постоянных и временных дисков
В этом примере показана разница между постоянным подключенным сетевым диском и временным диском PowerShell, подключенным к тому же сетевому ресурсу.
Если вы закрываете сеанс PowerShell, а затем открываете новый сеанс, временный диск PSDrive: недоступен, но доступен постоянный диск X:. Решая, какой метод использовать для подключения сетевых дисков, подумайте, как вы будете использовать диск. Например, должен ли он быть постоянным и должен ли диск быть видимым для других функций Windows.
Пример 6. Создание постоянного диска в сценарии
PSDrive создаются в области действия команды New-PSDrive. Когда команда запускается в сценарии, сопоставление дисков является локальным по отношению к сценарию. Когда скрипт завершает работу, диск становится недоступен.
Чтобы убедиться, что диск доступен вне сценария, необходимо использовать параметр Scope для создания диска в глобальной области.
Параметры
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Псевдонимы: | cf |
Позиция: | Имя |
Значение по умолчанию: | False | < /tr>
Принимать ввод конвейера: | False |
Допускать подстановочные знаки: | False |
Тип: | PSCredential |
Позиция: | Имя |
Значение по умолчанию: | Текущий пользователь |
Принять ввод конвейера: | Истина | < /tr>
Допускать подстановочные знаки: | False |
Указывает краткое текстовое описание диска. Введите любую строку.
Чтобы просмотреть описания всех дисков сеанса, Get-PSDrive | Имя таблицы форматов, описание .
Чтобы просмотреть описание конкретного диска, введите (Get-PSDrive ).Description .
Тип: | Строка |
Позиция: | Именованный |
Значение по умолчанию: | Нет |
Принять ввод конвейера: | Истина |
Допускать подстановочные знаки: | False |
Указывает имя для нового диска. Для постоянных подключенных сетевых дисков используйте букву диска. Для временных дисков PowerShell вы не ограничены буквами дисков, используйте любую допустимую строку.
Тип: | Строка |
Позиция: | 0 |
Значение по умолчанию: | Нет |
Принять ввод конвейера: | Истина |
Допускать подстановочные знаки: | False |
Указывает, что этот командлет создает подключенный сетевой диск Windows. Параметр Persist доступен только в Windows.
Подключенные сетевые диски сохраняются в Windows на локальном компьютере. Они сохраняются, не зависят от сеанса, и их можно просматривать и управлять ими в проводнике и других инструментах.
Когда вы выполняете команду локально, без точечного источника, параметр Persist не сохраняет создание PSDrive за пределами области, в которой вы запускаете команду.Если вы запускаете New-PSDrive внутри сценария и хотите, чтобы новый диск сохранялся бесконечно долго, вы должны указать исходный код сценария. Для достижения наилучших результатов, чтобы принудительно сохранить новый диск, укажите Global в качестве значения параметра Scope и включите Persist в свою команду.
Имя диска должно состоять из букв, например D или E . Значением параметра Root должен быть UNC-путь другого компьютера. Значение параметра PSProvider должно быть FileSystem .
Чтобы отключить подключенный сетевой диск Windows, используйте командлет Remove-PSDrive. Когда вы отключаете подключенный сетевой диск Windows, сопоставление удаляется с компьютера без возможности восстановления, а не просто удаляется из текущего сеанса.
Подключенные сетевые диски зависят от учетной записи пользователя. Подключенные диски, созданные в сеансах с повышенными правами или сеансах с использованием учетных данных другого пользователя, не видны в сеансах, запущенных с использованием других учетных данных.
Тип: | SwitchParameter |
Позиция: | Именованный |
Значение по умолчанию: | False |
Принять ввод конвейера: | True |
Допускать подстановочные знаки: | False |
Указывает поставщика PowerShell, который поддерживает диски такого типа.
Например, если диск связан с сетевым ресурсом или каталогом файловой системы, поставщиком PowerShell является FileSystem . Если диск связан с разделом реестра, поставщиком является реестр .
Временные диски PowerShell можно связать с любым поставщиком PowerShell. Подключенные сетевые диски могут быть связаны только с поставщиком файловой системы.
Чтобы просмотреть список поставщиков в сеансе PowerShell, используйте командлет Get-PSProvider.
Тип: | Строка |
Позиция: | 1 |
Значение по умолчанию: | Нет |
Принять ввод конвейера: | Истина |
Допускать подстановочные знаки: | False |
Указывает расположение хранилища данных, с которым сопоставляется диск PowerShell.
Например, укажите общий сетевой ресурс, например \\Server01\Public , локальный каталог, например C:\Program Files, или раздел реестра, например HKLM:\Software\Microsoft .
Временные диски PowerShell можно связать с локальным или удаленным расположением на любом диске поддерживаемого поставщика. Подключенные сетевые диски можно связать только с расположением файловой системы на удаленном компьютере.
Тип: | Строка |
Позиция: | 2 |
Значение по умолчанию: | Нет |
Принять ввод конвейера: | Истина |
Допускать подстановочные знаки: | False |
Тип: | Строка |
Позиция: | Именованный |
Значение по умолчанию: | Локальный |
Принять ввод конвейера: | Истина |
Допускать подстановочные знаки: | False |
Показывает, что произойдет, если командлет запустится. Командлет не запущен.
Тип: | SwitchParameter |
Псевдонимы: | wi |
Позиция: | Имя |
Значение по умолчанию: | False | < /tr>
Принимать ввод конвейера: | False |
Допускать подстановочные знаки: | False |