Compartilhar via

Convert-UrnToPath

Módulo:
SqlServer Module

Converte uma URN de Objeto de Gerenciamento do SQL Server em um caminho de provedor do Windows PowerShell.

Sintaxe

Default (Padrão) 

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

Description

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

Os Objetos de Gerenciamento do SQL Server têm 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 identificadores delimitados pelo SQL Server com caracteres estendidos que não têm suporte nos nós de caminho do 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 do 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 do SQL Server que identifica o local de um objeto na hierarquia do SQL Server.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

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

Saídas

String

Especifica uma cadeia de caracteres que representa um caminho de provedor do SQL Server PowerShell.