Share via

az security contact

  • Vista previa
  • Referencia

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Vea los contactos de seguridad.

Comandos

Nombre Description Tipo Estado
az security contact create

Crea un contacto de seguridad.

 Core Vista previa
az security contact delete

Elimine las configuraciones de contacto de seguridad de la suscripción.

 Core Vista previa
az security contact list

Enumere todas las configuraciones de contacto de seguridad de la suscripción.

 Core Vista previa
az security contact show

Obtenga las configuraciones de contacto de seguridad predeterminadas de la suscripción.

 Core Vista previa
az security contact update

Actualice las configuraciones de contacto de seguridad de la suscripción.

 Core Vista previa

az security contact create

Editar
Vista previa

El grupo de comandos "az security contact" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Crea un contacto de seguridad.

az security contact create --name
                           [--alert-notifications]
                           [--emails]
                           [--notifications-by-role]
                           [--phone]

Ejemplos

Crea un contacto de seguridad.

az security contact create -n 'default' --emails 'john@contoso.com;jane@contoso.com' --phone '214-275-4038' --notifications-by-role '{"state":"On","roles":["Owner"]}' --alert-notifications '{"state":"On","minimalSeverity":"Low"}'

Parámetros requeridos

--name --security-contact-name -n

Nombre del objeto de contacto de seguridad.

Parámetros opcionales

--alert-notifications

Define si se deben enviar notificaciones por correo electrónico sobre las nuevas alertas de seguridad: compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--emails

Lista de direcciones de correo electrónico que recibirán notificaciones de Microsoft Defender for Cloud por las configuraciones definidas en este contacto de seguridad.

--notifications-by-role

Define si se envían notificaciones por correo electrónico de Microsoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--phone

Número de teléfono del contacto de seguridad.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az security contact delete

Editar
Vista previa

El grupo de comandos "az security contact" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine las configuraciones de contacto de seguridad de la suscripción.

az security contact delete [--ids]
                           [--name]
                           [--subscription]
                           [--yes]

Ejemplos

Elimina un contacto de seguridad.

az security contact delete -n "default"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --security-contact-name -n

Nombre del objeto de contacto de seguridad.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az security contact list

Editar
Vista previa

El grupo de comandos "az security contact" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere todas las configuraciones de contacto de seguridad de la suscripción.

az security contact list [--max-items]
                         [--next-token]

Ejemplos

Obtiene todos los contactos de seguridad.

az security contact list

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az security contact show

Editar
Vista previa

El grupo de comandos "az security contact" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga las configuraciones de contacto de seguridad predeterminadas de la suscripción.

az security contact show [--ids]
                         [--name]
                         [--subscription]

Ejemplos

Obtener un contacto de seguridad.

az security contact show -n "default1"

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --security-contact-name -n

Nombre del objeto de contacto de seguridad.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az security contact update

Editar
Vista previa

El grupo de comandos "az security contact" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice las configuraciones de contacto de seguridad de la suscripción.

az security contact update [--add]
                           [--alert-notifications]
                           [--emails]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--ids]
                           [--name]
                           [--notifications-by-role]
                           [--phone]
                           [--remove]
                           [--set]
                           [--subscription]

Ejemplos

Novedades un contacto de seguridad.

az security contact update -n 'default' --emails 'john1@contoso.com;jane@contoso.com' --phone '214-275-4038' --notifications-by-role '{"state":"On","roles":["Owner"]}' --alert-notifications '{"state":"On","minimalSeverity":"Low"}'

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string o JSON string>.

--alert-notifications

Define si se deben enviar notificaciones por correo electrónico sobre las nuevas alertas de seguridad: compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--emails

Lista de direcciones de correo electrónico que recibirán notificaciones de Microsoft Defender for Cloud por las configuraciones definidas en este contacto de seguridad.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --security-contact-name -n

Nombre del objeto de contacto de seguridad.

--notifications-by-role

Define si se envían notificaciones por correo electrónico de Microsoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--phone

Número de teléfono del contacto de seguridad.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.