Cómo usar la documentación de PowerShell

Le damos la bienvenida a la documentación en línea de PowerShell. Este sitio contiene referencia de cmdlets para las siguientes versiones de PowerShell:

  • PowerShell 7.4 (LTS-Current)
  • PowerShell 7.3
  • PowerShell 7.2 (LTS-Current)
  • PowerShell 5.1

Captura de pantalla en la que se muestran varios elementos de la página web.

La página web contiene varios elementos que le ayudan a navegar por la documentación.

  • Navegación de nivel de sitio: la navegación de nivel de sitio aparece en la parte superior de la página. Contiene vínculos a otro contenido en la plataforma de Microsoft Learn.
  • Navegación de contenido relacionado: la barra de contenido relacionado está justo debajo de la navegación de nivel de sitio. Contiene vínculos a contenido relacionado con el conjunto de documentación actual que, en este caso, es PowerShell.
  • Selector de versión: el selector de versión aparece sobre la tabla de contenido (TOC) y controla qué versión de la referencia del cmdlet aparece en esta.
  • Tabla de contenido: la TOC del lado izquierdo de la página se divide en dos secciones: conceptual y referencia. Observe la línea que hay entre el nodo Referencia de la TOC. Los documentos conceptuales aparecen sobre la línea. El contenido de referencia aparece en el nodo Referencia que hay debajo de la línea.
  • Botones de acción: los botones de acción proporcionan una manera de agregar contenido a una colección, proporcionar comentarios, editar el contenido o compartirlo con otros usuarios.

Selección de la versión de PowerShell

Use el selector de versiones situado encima de la TOC para seleccionar la versión de PowerShell que quiera. De manera predeterminada, la página se carga con la versión estable más actual seleccionada. El selector de versión controla qué versión de la referencia de cmdlet aparece en la TOC del nodo Referencia. Algunos cmdlets funcionan de forma distinta en las diferentes versiones de PowerShell que se estén usando. Asegúrese de que está viendo la documentación de la versión correcta de PowerShell.

El selector de versiones no afecta a la documentación conceptual. Los documentos conceptuales se muestran por encima del nodo Referencia en la TOC. Aparecen los mismos artículos conceptuales para cada versión seleccionada. Si hay diferencias específicas de la versión, la documentación toma nota de ellas.

Animación en la que se muestra cómo usar el selector de versión.

Revise el valor $PSversionTable.PSVersion para comprobar la versión de PowerShell que usa. En el ejemplo siguiente se muestra la salida de Windows PowerShell 5.1.

$PSVersionTable.PSVersion
Major  Minor  Build  Revision
-----  -----  -----  --------
5      1      22621  963

Búsqueda de artículos

Hay dos maneras de buscar contenido en Docs.

  • El cuadro de búsqueda de la barra de navegación de nivel de sitio busca en todo el sitio. Devuelve una lista de artículos coincidentes de todos los conjuntos de documentación.
  • El cuadro de filtro TOC situado bajo el selector de versiones permite filtrar por palabras que aparecen en el título de un artículo. El filtro muestra una lista de artículos coincidentes a medida que escribe. También puede seleccionar la opción para buscar las palabras de un artículo. Al buscar desde aquí, la búsqueda se limita a la documentación de PowerShell.

En el ejemplo siguiente, la búsqueda en la barra de navegación de nivel de sitio devuelve 840 resultados para la palabra idempotent. Al escribir la palabra invoke en el cuadro de filtro TOC, se muestra una lista de artículos que contienen la palabra invoke en el título. Escribir la palabra idempotent en el filtro TOC no muestra ningún artículo. Al hacer clic en el vínculo de búsqueda, se busca idempotent en la documentación de PowerShell. Esta búsqueda solo devuelve 9 resultados.

Animación en la que se muestra cómo usar las características de búsqueda.

Descarga de la documentación como PDF

Para descargar la documentación como PDF, haga clic en el botón Descargar PDF situado en la parte inferior de la TOC.

Captura de pantalla del botón Descargar PDF.

  • Si está viendo un artículo conceptual, la plataforma Learn crea un PDF que contiene todo el contenido conceptual de la versión seleccionada.
  • Si está viendo un artículo de referencia, la plataforma Learn crea un PDF que contiene todo el contenido de referencia de la versión seleccionada.

Búsqueda de artículos de versiones anteriores

La documentación de las versiones anteriores de PowerShell está archivado en el sitio Versiones anteriores. Puede elegir Versiones anteriores en el selector de versiones.

Captura de pantalla de la opción Versiones anteriores.

Este sitio contiene documentación sobre los siguientes temas:

  • PowerShell 3.0
  • PowerShell 4.0
  • PowerShell 5.0
  • PowerShell 6
  • PowerShell 7.0
  • PowerShell 7.1
  • Flujos de trabajo de PowerShell
  • Acceso web a PowerShell