Convert-UrnToPath

Ссылка

Модуль:: SQLPS

Преобразует urn объекта управления SQL Server в путь поставщика Windows PowerShell.

Синтаксис

Convert-UrnToPath
       -Urn <String>
       [<CommonParameters>]

Описание

Командлет Convert-UrnToPath преобразует универсальное имя ресурса (URN) объекта управления SQL Server в путь поставщика SQL Server. У управляющих объектов SQL Server есть свойство URN, которое возвращает строку, указывающую их расположение в иерархии объектов SQL Server. Если узлы в urn SQL Server идентификаторы с расширенными символами, которые не поддерживаются в узлах пути Windows PowerShell, расширенные символы кодируются с помощью шестнадцатеричного представления. Например, имя таблицы Main:Table закодировано как Main%3ATable.

Примеры

Пример 1. Получение строки, содержащей текущий путь

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014"
PS SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014> Convert-UrnToPath -Urn (Get-Item .).Urn.ToString()
SQLSERVER:\SQL\MyComputer\MyInstance\Databases\AdventureWorks2014

Эта команда возвращает строку, содержащую текущий путь. В этом примере функция ToString() свойства Urn возвращает urn в виде строки.

Пример 2. Установка расположения пути на основе urn

PS C:\> Set-Location (Convert-UrnToPath -Urn "Server[@Name='MyComputer']/Database[@Name='AdventureWorks']/Table[@Name='Address' and @Schema = 'Person']")

Эта команда задает путь к расположению, указанному в urn объекта управления SQL Server.

Пример 3. Получение путей к базе данных

PS C:\> Set-Location "SQLSERVER:\SQL\MyComputer\DEFAULT\Databases"
PS SQLSERVER:\SQL\MyComputer\DEFAULT\Databases> ForEach ($Item in Get-ChildItem) { $Item.Urn.ToString() | Convert-UrnToPath }
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2014

Эта команда возвращает массив строк, содержащих путь к базе данных в экземпляре по умолчанию. Оператор конвейера используется для передачи текущего URN узла в Convert-UrnToPath.

Параметры

-Urn

Указывает SQL Server URN, определяющий расположение объекта в иерархии SQL Server.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

Входные данные

String

Указывает строку, представляющую urn объекта управления SQL Server.

Выходные данные