Поделиться через

Convert-UrnToPath

Модуль:
SqlServer Module

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

Синтаксис

Default (по умолчанию) 

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

Описание

Командлет Convert-UrnToPath преобразует универсальное имя ресурса объекта управления SQL Server (URN) в путь поставщика 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

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

Параметры

-Urn

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

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

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

String

Указывает строку, представляющую путь поставщика SQL Server PowerShell.