Convert-UrnToPath
Convertit un URN d’objet de gestion SQL Server en chemin d’accès du fournisseur Windows PowerShell.
Syntaxe
Default (Par défaut)
Convert-UrnToPath
[-Urn] <String>
[<CommonParameters>]
Description
L’applet de commande Convert-UrnToPath convertit un nom de ressource uniforme sql Server Management Object (URN) en chemin d’accès du fournisseur SQL Server.
Les objets d’administration SQL Server 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 des identificateurs délimités SQL Server avec des caractères étendus qui ne sont pas pris en charge dans les nœuds de chemin d’accès Windows PowerShell, 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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 du fournisseur SQL Server PowerShell.