Convert-UrnToPath
Преобразует URN объекта управления SQL Server в путь поставщика Windows PowerShell.
Синтаксис
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
Эта команда возвращает массив строк, содержащих путь к базе данных в экземпляре по умолчанию. Оператор конвейера используется для передачи текущего URN узла в Convert-UrnToPath.
Параметры
-Urn
Указывает SQL Server URN, определяющий расположение объекта в иерархии SQL Server.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Входные данные
String
Указывает строку, представляющую URN объекта управления SQL Server.
Выходные данные
String
Указывает строку, представляющую путь поставщика SQL Server PowerShell.