Convert-UrnToPath

Référence

Module:: SQLServer

Convertit un URN d’objet de gestion SQL Server en chemin d’accès du fournisseur Windows PowerShell.

Syntax

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

Description

L’applet de commande Convert-UrnToPath convertit un URN (SQL Server Management Object Uniform Resource Name) en chemin d’accès du fournisseur SQL Server.

Les objets SMO (SQL Server Management Objects) ont une propriété Urn qui retourne une chaîne indiquant leur emplacement dans la hiérarchie d'objets SQL Server.

Si les nœuds de l’Urn sont SQL Server identificateurs délimités avec des caractères étendus qui ne sont pas pris en charge dans Windows PowerShell nœuds de chemin d’accès, les caractères étendus sont encodés avec leur représentation hexadécimale.

Par exemple, un nom de table « Main:Table » est encodé en tant que « Main%3ATable ».

Exemples

Exemple 1 : Obtenir une chaîne contenant le chemin d’accès actuel

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

Cette commande retourne une chaîne qui contient le chemin d’accès actuel. L’exemple utilise la fonction ToString() de la propriété Urn pour renvoyer l’Urn en tant que chaîne.

Exemple 2 : Définir l’emplacement du chemin d’accès en fonction d’un URN

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

Cette commande définit le chemin d’accès à l’emplacement spécifié dans un URN d’objet de gestion SQL Server.

Exemple 3 : Obtenir des chemins de base de données

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

Cette commande retourne un tableau de chaînes qui contiennent le chemin d’accès à une base de données dans l’instance par défaut. L’opérateur de pipeline est utilisé pour passer l’URN de nœud actuel à Convert-UrnToPath.

Paramètres

-Urn

Spécifie un URN SQL Server qui identifie l’emplacement d’un objet dans la hiérarchie SQL Server.

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

Entrées

String

Spécifie une chaîne qui représente un URN d’objet de gestion SQL Server.

Sorties