Compartir a través de

New-SensitiveInformationScan

Módulo:
Exchange PowerShell

Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.

Use 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 con ámbito solo en archivos pdf y docx.

Parámetros

-Comment

Aplicable: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el 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. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar 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
Obligatorio: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: Cumplimiento de & de seguridad

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 nombre o dirección de correo electrónico. Puede usar el valor All 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 Más 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
Obligatorio: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: Cumplimiento de & de seguridad

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 excluirán en un examen de clasificación a petición para dispositivos. Identifica la cuenta por nombre o 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 Más 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
Obligatorio: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: Cumplimiento de & de seguridad

El parámetro ExceptIfOneDriveSharedBy especifica los usuarios que se excluirán del examen (los sitios de las cuentas de usuario de OneDrive se incluyen en el examen). Los usuarios se identifican 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 All, 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 se 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
Obligatorio: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: Cumplimiento de & de seguridad

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 All, 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 se puede usar este parámetro con los parámetros OneDriveSharedBy o OneDriveSharedByMemberOf.

No se 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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

Este parámetro especifica los sitios de OneDrive que se van a excluir cuando se usa el valor All 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
Obligatorio: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: Cumplimiento de & de seguridad

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). Los usuarios se identifican 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 All, 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 se 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
Obligatorio: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: Cumplimiento de & de seguridad

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 All, 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 se puede usar este parámetro con los parámetros ExceptIfOneDriveSharedBy o ExceptIfOneDriveSharedByMemberOf.

No se 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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

El parámetro SharePointLocationException especifica los sitios de SharePoint que se van a excluir cuando se usa el valor All 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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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: Cumplimiento de & de seguridad

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
Obligatorio: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.