SQL Server PowerShell ProviderSQL Server PowerShell Provider

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data WarehouseSe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data Warehouse

El proveedor de SQL ServerSQL Server para Windows PowerShell expone la jerarquía de objetos de SQL ServerSQL Server en rutas de acceso similares a las rutas de acceso al sistema de archivos.The SQL ServerSQL Server provider for Windows PowerShell exposes the hierarchy of SQL ServerSQL Server objects in paths similar to file system paths. Puede usar las rutas de acceso con el fin de buscar un objeto y, luego, usar los métodos de los modelos de Objetos de administración de SQL ServerSQL Server (SMO) para realizar acciones en los objetos.You can use the paths to locate an object, and then use methods from the SQL ServerSQL Server Management Object (SMO) models to perform actions on the objects.

Nota

Hay dos módulos de SQL Server PowerShell: SqlServer y SQLPS.There are two SQL Server PowerShell modules; SqlServer and SQLPS.

El módulo SqlServer es el módulo de PowerShell actual que se va a usar.The SqlServer module is the current PowerShell module to use.

El módulo SQLPS está incluido en la instalación de SQL Server (por motivos de compatibilidad con versiones anteriores), pero ya no se actualiza.The SQLPS module is included with the SQL Server installation (for backward compatibility) but is no longer updated.

El módulo SqlServer contiene versiones actualizadas de los cmdlets en SQLPS e incluye cmdlets para admitir las características más recientes de SQL.The SqlServer module contains updated versions of the cmdlets in SQLPS and includes new cmdlets to support the latest SQL features.

Instale el módulo SqlServer desde la Galería de PowerShell.Install the SqlServer module from the PowerShell Gallery.

Para más información, consulte el artículo sobre SQL Server PowerShell.For more information, see SQL Server PowerShell.

Ventajas del proveedor de PowerShell de SQL ServerBenefits of the SQL Server PowerShell Provider

Las rutas de acceso que implementa el proveedor de SQL ServerSQL Server habilitan la revisión sencilla e interactiva de todos los objetos de una instancia de SQL Server.The paths implemented by the SQL ServerSQL Server provider enable easily and interactively reviewing all of the objects in an instance of SQL Server. Puede navegar por las rutas de acceso mediante alias de Windows PowerShell similares a los comandos que se usan normalmente para navegar por las rutas de acceso al sistema de archivos.You can navigate the paths using Windows PowerShell aliases similar to the commands you typically use to navigate file system paths.

Jerarquía de SQL Server PowerShellThe SQL Server PowerShell Hierarchy

Los productos cuyos datos o modelos de objetos se pueden representar en una jerarquía usan proveedores de Windows PowerShell para exponer las jerarquías.Products whose data or object models can be represented in a hierarchy use Windows PowerShell providers to expose the hierarchies. La jerarquía se expone mediante el uso de una unidad y una estructura parecidas a las que usa el sistema de archivos de Windows.The hierarchy is exposed by using a drive and path structure similar to what the Windows file system uses.

Cada proveedor de Windows PowerShell implementa una o varias unidades.Each Windows PowerShell provider implements one or more drives. Cada unidad es el nodo raíz de una jerarquía de objetos relacionados.Each drive is the root node of a hierarchy of related objects. El proveedor de SQL ServerSQL Server implementa un SQLSERVER: unidad de disco.The SQL ServerSQL Server provider implements a SQLSERVER: drive. El proveedor también define un conjunto de carpetas principales para el SQLSERVER: unidad de disco.The provider also defines a set of primary folders for the SQLSERVER: drive. Cada carpeta y sus subcarpetas representan el conjunto de objetos a los que se puede tener acceso usando un modelo de objetos de administración de SQL ServerSQL Server .Each folder and its subfolders represent the set of objects that can be accessed by using a SQL ServerSQL Server management object model. Cuando se centra en una subcarpeta de una ruta de acceso que se inicia con una de estas carpetas principales, se pueden usar los métodos del modelo de objetos asociado para realizar las acciones en el objeto representado por el nodo.When you are focused on a subfolder in a path that starts with one of these primary folders, you can use the methods from the associated object model to perform actions on the object that is represented by the node. En la tabla siguiente se muestran las carpetas de Windows PowerShell que implementa el proveedor SQL ServerSQL Server:The Windows PowerShell folders implemented by the SQL ServerSQL Server provider are listed in the following table:

CarpetaFolder Espacio de nombres del modelo de objetos de SQL ServerSQL Server object model namespace ObjetosObjects
SQLSERVER:\SQL Microsoft.SqlServer.Management.Smo

Microsoft.SqlServer.Management.Smo.Agent

Microsoft.SqlServer.Management.Smo.Broker

Microsoft.SqlServer.Management.Smo.Mail
Objetos de base de datos, como tablas, vistas y procedimientos almacenados.Database objects, such as tables, views, and stored procedures.
SQLSERVER:\SQLPolicy Microsoft.SqlServer.Management.Dmf

Microsoft.SqlServer.Management.Facets
Objetos de administración basada en directivas, como directivas y facetas.Policy-based management objects, such as policies and facets.
SQLSERVER:\SQLRegistration Microsoft.SqlServer.Management.RegisteredServers

Microsoft.SqlServer.Management.Smo.RegSvrEnum
Objetos de servidor registrado, como los grupos de servidores y los servidores registrados.Registered server objects, such as server groups and registered servers.
SQLSERVER:\Utility Microsoft.SqlServer.Management.Utility Los objetos de utilidad, como las instancias administradas de Motor de base de datosDatabase Engine.Utility objects, such as managed instances of the Motor de base de datosDatabase Engine.
SQLSERVER:\DAC Microsoft.SqlServer.Management.DacMicrosoft.SqlServer.Management.Dac Objetos de aplicación de capa de datos, como los paquetes DAC, y operaciones como la implementación de una DAC.Data-tier application objects such as DAC packages, and operations such as deploying a DAC.
SQLSERVER:\DataCollection Microsoft.SqlServer.Management.Collector Objetos de recopilador de datos, como conjuntos de recopilación y almacenes de configuración.Data collector objects, such as collection sets and configuration stores.
SQLSERVER:\SSIS Microsoft.SqlServer.Management.IntegrationServices Integration ServicesIntegration Services como proyectos, paquetes, y entornos.objects such as projects, packages, and environments.
SQLSERVER:\XEvent Microsoft.SqlServer.Management.XEvent Eventos extendidos de SQL ServerSQL Server Extended Events
SQLSERVER:\DatabaseXEvent Microsoft.SqlServer.Management.XEventDbScopedMicrosoft.SqlServer.Management.XEventDbScoped Eventos extendidos de SQL ServerSQL Server Extended Events
SQLSERVER:\SQLAS Microsoft.AnalysisServices Analysis ServicesAnalysis Services objetos como cubos, agregaciones, y dimensiones.objects such as cubes, aggregations, and dimensions.

Por ejemplo, puede usar la carpeta SQLSERVER:\SQL para iniciar rutas de acceso que puedan representar cualquier objeto admitido por el modelo de objetos SMO.For example, you can use the SQLSERVER:\SQL folder to start paths that can represent any object that is supported by the SMO object model. La parte inicial de una ruta de acceso SQLSERVER:\SQL es SQLSERVER:\SQL\nombreDeEquipo\nombreDeInstancia.The leading part of a SQLSERVER:\SQL path is SQLSERVER:\SQL\ComputerName\InstanceName. Los nodos que siguen al nombre de instancia alternan entre colecciones de objetos (como Bases de datos o Vistas) y nombres de objeto (como AdventureWorks2012).The nodes after the instance name alternate between object collections (such as Databases or Views) and object names (such as AdventureWorks2012). Los esquemas no se representan como clases de objeto.Schemas are not represented as object classes. Cuando se especifica el nodo para un objeto de nivel superior en un esquema, como una tabla o una vista, se debe especificar el nombre de objeto en el formato nombreDeEsquema.nombreDeObjeto.When you specify the node for a top-level object in a schema, such as a table or view, you must specify the object name in the format SchemaName.ObjectName.

En el siguiente ejemplo se muestra la ruta de acceso de la tabla Vendor en el esquema Purchasing de la base de datos AdventureWorks2012 en una instancia predeterminada de Motor de base de datosDatabase Engine en el equipo local:The following example shows the path of the Vendor table in the Purchasing schema of the AdventureWorks2012 database in a default instance of the Motor de base de datosDatabase Engine on the local computer:

SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2012\Tables\Purchasing.Vendor  

Para obtener más información acerca de la jerarquía del modelo de objetos SMO, vea SMO Object Model Diagram.For more information about the SMO object model hierarchy, see SMO Object Model Diagram.

Los nodos de colección de una ruta de acceso se asocian con una clase de colecciones del modelo de objetos asociado.Collection nodes in a path are associated with a collection class in the associated object model. Los nodos de nombre de objeto se asocian a una clase de objetos del modelo de objetos asociado, como en la tabla siguiente:Object name nodes are associated with an object class in the associated object model, as in the following table:

PathPath Clase SMOSMO class
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases DatabaseCollection
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2012 Database

Tareas del proveedor de SQL ServerSQL Server Provider Tasks

Descripción de la tareaTask Description ArtículoArticle
Describe cómo usar los cmdlets de Windows PowerShell para navegar por los nodos de una ruta de acceso, y en cada nodo obtener una lista de los objetos de ese nodo.Describes how to use Windows PowerShell cmdlets to navigate through the nodes in a path, and at each node get a list of the objects at that node. Navegar por las rutas de acceso de SQL Server PowerShellNavigate SQL Server PowerShell Paths
Describe cómo usar los métodos y las propiedades de SMO para notificar y trabajar en el objeto representado por un nodo de una ruta de acceso.Describes how to use the SMO methods and properties to report on and perform work on the object represented by a node in a path. También describe cómo obtener una lista de los métodos y propiedades de SMO para ese nodo.Also describes how to get a list of the SMO methods and properties for that node. Trabajar con rutas acceso de SQL Server PowerShellWork With SQL Server PowerShell Paths
Describe cómo convertir un nombre de recursos uniforme (URN) (URN) de SMO a una ruta de acceso del proveedor de SQL Server.Describes how to convert a SMO Uniform Resource Name (URN) to a SQL Server provider path. Convertir URN en rutas de acceso del proveedor de SQL ServerConvert URNs to SQL Server Provider Paths
Describe cómo abrir las conexiones de autenticación de SQL Server mediante el proveedor de SQL ServerSQL Server .Describes how to open SQL Server Authentication connections by using the SQL ServerSQL Server provider. De forma predeterminada, el proveedor usa conexiones con autenticación de Windows realizadas mediante las credenciales de la cuenta de Windows que ejecuta la sesión de Windows PowerShell.By default, the provider uses Windows Authentication connections made using the credentials of the Windows account running the Windows PowerShell session. Administrar la autenticación en PowerShell del motor de base de datosManage Authentication in Database Engine PowerShell

Pasos siguientesNext steps

SQL Server PowerShellSQL Server PowerShell