Convert-UrnToPath
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
String
Spécifie une chaîne qui représente un chemin d’accès de fournisseur PowerShell SQL Server.