Convert-UrnToPath

Referência

Módulo:: SQLServer

Converte uma URN do objeto de gerenciamento de SQL Server em um caminho de provedor de Windows PowerShell.

Syntax

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

Description

O cmdlet Convert-UrnToPath converte uma URN (Nome do Recurso Uniforme do Objeto de Gerenciamento de SQL Server) em um caminho de provedor de SQL Server.

O SQL Server Management Objects tem uma propriedade Urn que retorna uma cadeia de caracteres indicando sua localização na hierarquia de objetos do SQL Server.

Se os nós na Urn forem SQL Server identificadores delimitados com caracteres estendidos que não têm suporte em nós de caminho Windows PowerShell, os caracteres estendidos serão codificados com sua representação hexadecimal.

Por exemplo, um nome de tabela "Main:Table" é codificado como "Main%3ATable".

Exemplos

Exemplo 1: Obter uma cadeia de caracteres que contém o caminho atual

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

Esse comando retorna uma cadeia de caracteres que contém o caminho atual. O exemplo usa a função ToString() da propriedade Urn para retornar a URN como uma cadeia de caracteres.

Exemplo 2: Definir o local do caminho com base em uma URN

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

Esse comando define o caminho para o local especificado em uma URN do objeto de gerenciamento de SQL Server.

Exemplo 3: Obter caminhos de banco de dados

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

Esse comando retorna uma matriz de cadeias de caracteres que contêm o caminho para um banco de dados na instância padrão. O operador de pipeline é usado para passar a URN do nó atual para Convert-UrnToPath.

Parâmetros

-Urn

Especifica uma URN SQL Server que identifica o local de um objeto na hierarquia SQL Server.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

String

Especifica uma cadeia de caracteres que representa uma URN do objeto de gerenciamento SQL Server.

Saídas