Parcourir les chemins d'accès PowerShell SQL Server
Le fournisseur PowerShell du Moteur de base de données expose le jeu d'objets dans une instance de SQL Server dans une structure similaire à un chemin d'accès de fichier. Vous pouvez utiliser des applets de commande Windows PowerShell pour naviguer jusqu'au chemin d'accès du fournisseur et créer des lecteurs personnalisés pour raccourcir le chemin d'accès que vous devez taper.
Avant de commencer
Windows PowerShell implémente des applets de commande pour parcourir la structure de chemin d'accès qui représentent la hiérarchie des objets pris en charge par un fournisseur PowerShell. Une fois que vous avez accédé à un nœud dans le chemin d'accès, vous pouvez utiliser d'autres applets de commande pour exécuter des opérations de base sur l'objet actif. Étant donné que les applets de commande sont fréquemment utilisées, elles ont des alias canoniques courts. Il existe également un ensemble d'alias qui mappent les applets de commande à des commandes semblables destinées à l'invite de commandes, et un autre ensemble pour les commandes de l'interpréteur de commandes UNIX.
Le fournisseur SQL Server implémente un sous-ensemble des applets de commande du fournisseur, comme indiqué dans le tableau suivant.
Applet de commande |
Alias canonique |
Alias d'applet de commande |
Alias de l'interpréteur de commandes UNIX |
Description |
---|---|---|---|---|
Get-Location |
gl |
pwd |
pwd |
Obtient le nœud actuel. |
Set-Location |
sl |
cd, chdir |
cd, chdir |
Modifie le nœud actuel. |
Get-ChildItem |
gci |
dir |
ls |
Répertorie les objets stockés sur le nœud actuel. |
Get-Item |
gi |
Retourne les propriétés de l'élément actif. |
||
Rename-Item |
rni |
rn |
ren |
Renomme un objet. |
Remove-Item |
ri |
del, rd |
rm, rmdir |
Supprime un objet. |
Important
Certains identificateurs (noms d'objets) SQL Server contiennent des caractères que Windows PowerShell ne prend pas en charge dans les noms de chemins d'accès. Pour plus d'informations sur l'utilisation de noms qui contiennent ces caractères, consultez Identificateurs SQL Server dans PowerShell.
Informations de SQL Server retournées par Get-ChildItem
Les informations retournées par Get-ChildItem (ou ses alias dir et ls) dépendent de votre emplacement dans un chemin d'accès SQLSERVER:.
Emplacement de chemin d'accès |
Résultats de Get-ChildItem |
---|---|
SQLSERVER:\SQL |
Retourne le nom de l'ordinateur local. Si vous avez utilisé SMO ou WMI pour vous connecter aux instances du Moteur de base de données sur d'autres ordinateurs, ces ordinateurs sont également répertoriés. |
SQLSERVER:\SQL\ComputerName |
Liste des instances du Moteur de base de données sur l'ordinateur. |
SQLSERVER:\SQL\ComputerName\InstanceName |
Liste des types d'objets de niveau supérieur dans l'instance, tels que les points de terminaison, les certificats et les bases de données. |
Nœud de classes d'objets, tels que Databases |
Liste des objets de ce type, telle que la liste des bases de données : master, model, AdventureWorks20008R2. |
Nœud de nom d'objet, tel qu' AdventureWorks2012 |
Liste des types d'objets contenus dans l'objet. Par exemple, une base de données répertorierait des types d'objets tels que les tables et les vues. |
Par défaut, Get-ChildItem ne répertorie pas d'objets système. Utilisez le paramètre Force pour afficher les objets système, tels que les objets dans le schéma sys.
Lecteurs personnalisés
Windows PowerShell permet aux utilisateurs de définir des lecteurs virtuels appelés lecteurs PowerShell, qui sont mappés aux nœuds de démarrage d'une instruction de chemin d'accès. Ils sont généralement utilisés pour raccourcir les chemins d'accès fréquemment tapés. Les chemins d'accès SQLSERVER: peuvent devenir longs, occupant beaucoup de place dans la fenêtre Windows PowerShell et nécessitant beaucoup de saisie. Si vous devez effectuer beaucoup de travail sur un nœud de chemin d'accès particulier, vous pouvez définir un lecteur Windows PowerShell personnalisé mappé à ce nœud.
Utiliser des alias d'applets de commande PowerShell
Utiliser un alias d'applet de commande
- Au lieu de taper un nom d'applet de commande complet, tapez un alias plus court ou un alias mappé à une commande d'invite de commandes familière.
Exemple d'alias (PowerShell)
Par exemple, vous pouvez utiliser l'un des jeux d'applets de commande ou ensembles d'alias suivants pour récupérer la liste des instances SQL Server disponibles si vous accédez au dossier SQLSERVER:\SQL et si vous demandez la liste des éléments enfants de ce dossier :
## Shows using the full cmdet name.
Set-Location SQLSERVER:\SQL
Get-ChildItem
## Shows using canonical aliases.
sl SQLSERVER:\SQL
gci
## Shows using command prompt aliases.
cd SQLSERVER:\SQL
dir
## Shows using Unix shell aliases.
cd SQLSERVER:\SQL
ls
Utiliser Get-ChildItem
Renvoyer des informations à l'aide de Get-Childitem
Accédez au nœud pour lequel vous souhaitez obtenir une liste de childrem
Exécutez Get-Childitem pour obtenir la liste.
Exemple de Get-ChildItem (PowerShell)
Ces exemples illustrent les informations retournées par Get-Childitem pour différents nœuds dans un chemin d'accès de fournisseur SQL Server.
## Return the current computer and any computer
## to which you have made a SQL or WMI connection.
Set-Location SQLSERVER:\SQL
Get-ChildItem
## List the instances of the Database Engine on the local computer.
Set-Location SQLSERVER:\SQL\localhost
Get-ChildItem
## Lists the categories of objects available in the
## default instance on the local computer.
Set-Location SQLSERVER:\SQL\localhost\DEFAULT
Get-ChildItem
## Lists the databases from the local default instance.
## The force parameter is used to include the system databases.
Set-Location SQLSERVER:\SQL\localhost\DEFAULT\Databases
Get-ChildItem -force
Créer un lecteur personnalisé
Créer et utiliser un lecteur personnalisé
Utilisez New-PSDrive pour définir un lecteur personnalisé. Utilisez le paramètre Root pour spécifier le chemin d'accès représenté par le nom du lecteur personnalisé.
Faites référence au nom du lecteur personnalisé dans les applets de commande de navigation de chemin d'accès telles que Set-Location.
Exemple de lecteur personnalisé (PowerShell)
Cet exemple crée un lecteur virtuel nommé AWDB qui mappe au nœud pour une copie déployée de l'exemple de base de données AdventureWorks2012. Le lecteur virtuel est ensuite utilisé pour naviguer jusqu'à une table dans la base de données.
## Create a new virtual drive.
New-PSDrive -Name AWDB -Root SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2012
## Use AWDB: to navigate to a specific table.
Set-Location AWDB:\Tables\Purchasing.Vendor
Voir aussi
Concepts
Fournisseur PowerShell SQL Server
Utiliser des chemins d'accès PowerShell SQL Server
Convertir des URN en chemins d'accès de fournisseur SQL Server