Convert-UrnToPath
Converte um URN do Objeto de Gerenciamento de SQL Server em um caminho de provedor de Windows PowerShell.
Sintaxe
Convert-UrnToPath
-Urn <String>
[<CommonParameters>]
Description
O cmdlet Convert-UrnToPath converte um URN (nome de 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 no 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 um 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 um 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 o URN do nó atual para Convert-UrnToPath.
Parâmetros
-Urn
Especifica um URN SQL Server que identifica o local de um objeto na hierarquia de SQL Server.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Entradas
String
Especifica uma cadeia de caracteres que representa um URN do Objeto de Gerenciamento de SQL Server.
Saídas
String
Especifica uma cadeia de caracteres que representa um SQL Server caminho do provedor do PowerShell.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de