New-SensitiveInformationScan
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Usar el cmdlet New-SensitiveInformationScan para crear nuevos exámenes de clasificación a petición. Obtenga más información sobre las clasificaciones a petición en Clasificación a petición.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (valor predeterminado)
New-SensitiveInformationScan
[-Name] <String>
[-Comment <String>]
[-Confirm]
[-EndpointDlpLocation <MultiValuedProperty>]
[-EndpointDlpLocationException <MultiValuedProperty>]
[-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
[-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeSender <SmtpAddress[]>]
[-ExchangeSenderException <SmtpAddress[]>]
[-ExchangeSenderMemberOf <RecipientIdParameter[]>]
[-ExchangeSenderMemberOfException <RecipientIdParameter[]>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-OneDriveSharedBy <RecipientIdParameter[]>]
[-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-TeamsLocation <MultiValuedProperty>]
[-TeamsLocationException <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
New-SensitiveInformationScan "SharePoint scan" -SharePointLocation All
New-SensitiveInformationScanRule "SharePoint scan rule" -ContentExtensionMatchesWords "pdf", "docx" -Policy "SharePoint scan" -Workload SharePoint
En este ejemplo se crea un examen de todos los sitios de SharePoint que tienen como ámbito solo los archivos pdf y docx.
Parámetros
-Comment
Aplicable: Seguridad & cumplimiento
El parámetro Comment especifica un comentario opcional. Si especifica un valor que contenga espacios, escríbalo entre comillas ("), por ejemplo: "Esto es una nota del administrador".
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: Seguridad & cumplimiento
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EndpointDlpLocation
Aplicable: Seguridad & cumplimiento
Nota: Este parámetro requiere la pertenencia a los roles Administrador de cumplimiento o Administrador de datos de cumplimiento en Microsoft Entra ID.
El parámetro EndpointDLPLocation especifica las cuentas de usuario que se incluirán en el examen de dispositivos. Identifica la cuenta por el nombre o la dirección de correo electrónico. Puede utilizar el valor Todas para incluir todas las cuentas de usuario.
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
Para obtener más información sobre la incorporación de dispositivos a Purview, consulte Obtener información sobre la incorporación de dispositivos).
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-EndpointDlpLocationException
Aplicable: Seguridad & cumplimiento
Nota: Este parámetro requiere la pertenencia a los roles Administrador de cumplimiento o Administrador de datos de cumplimiento en Microsoft Entra ID.
El parámetro EndpointDlpLocationException especifica las cuentas de usuario que se deben excluir en un examen de clasificación a petición de dispositivos. Identifica la cuenta por el nombre o la dirección de correo electrónico.
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
Para obtener más información sobre la incorporación de dispositivos a Purview, consulte Obtener información sobre la incorporación de dispositivos).
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExceptIfOneDriveSharedBy
Aplicable: Seguridad & cumplimiento
El parámetro ExceptIfOneDriveSharedBy especifica los usuarios que se deben excluir del examen (los sitios de las cuentas de usuario de OneDrive se incluyen en el examen). Identifica a los usuarios por UPN (laura@contoso.onmicrosoft.com).
Para usar este parámetro, los sitios de OneDrive deben incluirse en el examen (el valor del parámetro OneDriveLocation es Todos, que es el valor predeterminado).
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
No puede usar este parámetro con los parámetros OneDriveSharedBy o OneDriveSharedByMemberOf.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExceptIfOneDriveSharedByMemberOf
Aplicable: Seguridad & cumplimiento
El parámetro ExceptIfOneDriveSharedByMemberOf especifica los grupos de distribución o los grupos de seguridad habilitados para correo que se excluirán del examen (los sitios de OneDrive de los miembros del grupo se excluyen del examen). Los grupos se identifican por dirección de correo electrónico.
Para usar este parámetro, los sitios de OneDrive deben incluirse en el examen (el valor del parámetro OneDriveLocation es Todos, que es el valor predeterminado).
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
No puede usar este parámetro con los parámetros OneDriveSharedBy o OneDriveSharedByMemberOf.
No puede usar este parámetro para especificar Grupos de Microsoft 365.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeLocation
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeSender
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | SmtpAddress[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeSenderException
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | SmtpAddress[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeSenderMemberOf
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExchangeSenderMemberOfException
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Seguridad & cumplimiento
El parámetro Name especifica el nombre único del examen. Si el valor contiene espacios, escríbalo entre comillas.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OneDriveLocation
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OneDriveLocationException
Aplicable: Seguridad & cumplimiento
Este parámetro especifica los sitios de OneDrive que se excluirán al usar el valor Todos para el parámetro OneDriveLocation. Identifique el sitio por su valor de dirección URL.
Update Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OneDriveSharedBy
Aplicable: Seguridad & cumplimiento
El parámetro OneDriveSharedBy especifica los usuarios que se incluirán en el examen (los sitios de las cuentas de usuario de OneDrive se incluyen en el examen). Identifica a los usuarios por UPN (laura@contoso.onmicrosoft.com).
Para usar este parámetro, los sitios de OneDrive deben incluirse en el examen (el valor del parámetro OneDriveLocation es Todos, que es el valor predeterminado).
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
No puede usar este parámetro con los parámetros ExceptIfOneDriveSharedBy o ExceptIfOneDriveSharedByMemberOf.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OneDriveSharedByMemberOf
Aplicable: Seguridad & cumplimiento
El parámetro OneDriveSharedByMemberOf especifica los grupos de distribución o los grupos de seguridad habilitados para correo que se incluirán en el examen (los sitios de OneDrive de los miembros del grupo se incluyen en el examen). Los grupos se identifican por dirección de correo electrónico.
Para usar este parámetro, los sitios de OneDrive deben incluirse en el examen (el valor del parámetro OneDriveLocation es Todos, que es el valor predeterminado).
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
No puede usar este parámetro con los parámetros ExceptIfOneDriveSharedBy o ExceptIfOneDriveSharedByMemberOf.
No puede usar este parámetro para especificar Grupos de Microsoft 365.
Propiedades de parámetro
| Tipo: | RecipientIdParameter[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PolicyRBACScopes
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SharePointLocation
Aplicable: Seguridad & cumplimiento
El parámetro SharePointLocation especifica los sitios de SharePoint que se incluirán en el examen. Identifique el sitio por su valor de dirección URL o use el valor All para incluir todos los sitios.
No puede agregar sitios de SharePoint a la directiva hasta que se hayan indexado.
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SharePointLocationException
Aplicable: Seguridad & cumplimiento
El parámetro SharePointLocationException especifica los sitios de SharePoint que se excluirán cuando se usa el valor Todos para el parámetro SharePointLocation. Identifique el sitio por su valor de dirección URL.
No puede agregar sitios de SharePoint al examen hasta que se hayan indexado.
Para escribir varios valores, use esta sintaxis: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TeamsLocation
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TeamsLocationException
Aplicable: Seguridad & cumplimiento
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | MultiValuedProperty |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Seguridad & cumplimiento
El modificador WhatIf no funciona en Security & Compliance PowerShell.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.