Compartir a través de

Install-Scanner

  • Referencia
Módulo:
PurviewInformationProtection

Instala el analizador de Microsoft Purview Information Protection.

Sintaxis

Install-Scanner
       [-ServiceUserCredentials] <PSCredential>
       [-StandardDomainsUserAccount <PSCredential>]
       [-ShareAdminUserAccount <PSCredential>]
       [-SqlServerInstance]
       [-Cluster |
       -Profile <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Install-Scanner instala y configura el analizador de Microsoft Purview Information Protection en un equipo que ejecuta Windows Server 2022, Windows Server 2019, Windows Server 2016 o Windows Server 2012 R2.

El analizador de Microsoft Purview Information Protection usa este servicio para examinar archivos en almacenes de datos que usan el protocolo Bloque de mensajes del servidor (SMB) y en SharePoint local. Los archivos que detecta este analizador se pueden etiquetar para aplicar la clasificación y, opcionalmente, aplicar protección o quitar la protección.

Para obtener más información sobre cómo configurar las etiquetas y las opciones de directiva, consulte: Introducción a las etiquetas de confidencialidad.

Importante

Debe ejecutar este cmdlet antes de ejecutar cualquier otro cmdlet para el analizador de Microsoft Purview Information Protection.

El comando crea un servicio de Windows denominado Information Protection Scanner. También crea y configura una base de datos en SQL Server para almacenar la configuración y la información operativa del analizador. El servicio que especifique para ejecutar el analizador se concede automáticamente los derechos necesarios para leer y escribir en la base de datos que se crea.

Para ejecutar este comando, debe tener derechos de administrador local para el equipo con Windows Server y derechos sysadmin en la instancia de SQL Server que usará para el analizador.

Después de ejecutar este comando, use el portal de cumplimiento Microsoft Purview para configurar las opciones en el clúster del analizador y especifique los repositorios de datos que se van a examinar. Antes de ejecutar el analizador, debe ejecutar el cmdlet Set-Authentication una vez para iniciar sesión en Azure AD para la autenticación y autorización.

Para obtener instrucciones paso a paso para instalar, configurar y usar el analizador, consulte Más información sobre el analizador de protección de la información.

Ejemplos

Ejemplo 1: Instalación del servicio Microsoft Purview Information Protection Scanner mediante una instancia de SQL Server y un clúster

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1\MIPSCANNER -Cluster EU

Este comando instala el servicio Microsoft Purview Information Protection Scanner mediante una instancia de SQL Server denominada MIPSCANNER, que se ejecuta en el servidor denominado SQLSERVER1.

Además, la instalación crea el nombre de la base de datos de nombre> AIPScannerUL_<cluster para almacenar la configuración del analizador, a menos que ya se encuentre una base de datos existente con el mismo nombre.

Se le pedirá que proporcione los detalles de la cuenta de Active Directory para la cuenta de servicio del analizador.

El comando muestra el progreso de la instalación, donde se encuentra el registro de instalación y la creación del nuevo registro de eventos de aplicación de Windows denominado Microsoft Purview Information Protection Scanner

Al final de la salida, verá Que se ha completado la instalación de transacciones.

Ejemplo 2: Instalación del servicio Microsoft Purview Information Protection Scanner mediante la instancia predeterminada de SQL Server

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1 -Cluster EU

Este comando instala el servicio de escáner de Microsoft Purview Information Protection mediante la instancia predeterminada SQL Server que se ejecuta en el servidor denominado SQLSERVER1.

Al igual que en el ejemplo anterior, se le pedirán credenciales y, a continuación, el comando muestra el progreso, donde se encuentra el registro de instalación y la creación del nuevo registro de eventos de aplicación de Windows.

Ejemplo 3: Instalación del servicio de escáner de Microsoft Purview Information Protection mediante SQL Server Express

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1\SQLEXPRESS -Cluster EU

Este comando instala el servicio Microsoft Purview Information Protection Scanner mediante SQL Server Express que se ejecuta en el servidor denominado SQLSERVER1.

Al igual que con los ejemplos anteriores, se le pedirán credenciales y, a continuación, el comando muestra el progreso, donde se encuentra el registro de instalación y la creación del nuevo registro de eventos de aplicación de Windows.

Parámetros

-Cluster

Especifica el nombre de la base de datos del analizador para la configuración del analizador mediante la sintaxis siguiente: AIPScannerUL_<cluster_name>.

Si la base de datos que se denomina no existe cuando se instala el analizador, este comando lo crea.

El uso de este parámetro o el parámetro Profile es obligatorio. Se recomienda usar este parámetro en lugar del parámetro Profile .

Tipo:String
Alias:Profile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el nombre de la base de datos del analizador para la configuración del analizador.

El uso de este parámetro o el parámetro Cluster es obligatorio. Se recomienda usar el parámetro Cluster en lugar del parámetro this.

El nombre de la base de datos del analizador es AIPScannerUL_<profile_name>.

Si la base de datos que se denomina no existe cuando se instala el analizador, este comando lo crea.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ServiceUserCredentials

Especifica las credenciales de cuenta usadas para ejecutar el analizador de Microsoft Purview Information Protection.

  • Las credenciales usadas deben ser una cuenta de Active Directory.

  • Establezca el valor de este parámetro mediante la sintaxis siguiente: Domain\Username.

    Por ejemplo: contoso\scanneraccount

  • Si no especifica este parámetro, se le pedirá el nombre de usuario y la contraseña.

Para obtener más información, consulte Requisitos previos para el analizador de Microsoft Purview Information Protection.

Sugerencia

Use un objeto PSCredential mediante el cmdlet Get-Credential . En este caso, solo se le pedirá la contraseña.

Para obtener más información, escriba Get-Help Get-Cmdlet.

Tipo:PSCredential
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ShareAdminUserAccount

Especifica las credenciales de una cuenta segura en una red local, que se usa para obtener una lista completa de los permisos NTFS y del recurso compartido de archivos.

  • Las credenciales usadas deben ser una cuenta de Active Directory con derechos de administrador o FC en los recursos compartidos de red. Normalmente, se trata de un Administración de servidor o un Administración de dominio.

  • Establezca el valor de este parámetro mediante la sintaxis siguiente: Domain\Username

    Por ejemplo: contoso\admin

  • Si no especifica este parámetro, se le pedirá el nombre de usuario y la contraseña.

Sugerencia

Use un objeto PSCredential mediante el cmdlet Get-Credential . En este caso, solo se le pedirá la contraseña.

Para obtener más información, escriba Get-Help Get-Cmdlet.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SqlServerInstance

Especifica la instancia de SQL Server en la que se va a crear una base de datos para el analizador de Microsoft Purview Information Protection.

Para obtener información sobre los requisitos de SQL Server, consulte Requisitos previos para el analizador de Microsoft Purview Information Protection.

  • Para la instancia predeterminada, especifique el nombre del servidor. Por ejemplo: SQLSERVER1.

  • Para una instancia con nombre, especifique el nombre del servidor y el nombre de la instancia. Por ejemplo: SQLSERVER1\MIPSCANNER.

  • Para SQL Server Express, especifique el nombre del servidor y SQLEXPRESS. Por ejemplo: SQLSERVER1\SQLEXPRESS.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StandardDomainsUserAccount

Especifica las credenciales de una cuenta débil en una red local, que se usa para comprobar el acceso de los usuarios débiles de la red y exponer los recursos compartidos de red detectados.

  • Las credenciales usadas deben ser una cuenta de Active Directory y un usuario del grupo Usuarios de dominio solo.

  • Establezca el valor de este parámetro mediante la sintaxis siguiente: Domain\Username

    Por ejemplo: contoso\stduser

  • Si no especifica este parámetro, se le pedirá el nombre de usuario y la contraseña.

Sugerencia

Use un objeto PSCredential mediante el cmdlet Get-Credential . En este caso, solo se le pedirá la contraseña.

Para obtener más información, escriba Get-Help Get-Cmdlet.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object