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.

Syntaxe

Convert-UrnToPath
       [-Urn] <String>
       [-ProgressAction <ActionPreference>]
       [<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

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:	ActionPreference
Alias:	proga
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Urn

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

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

Entrées

String

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

Sorties