Compartir a través de


az devops security group

Note

Esta referencia forma parte de la extensión azure-devops para la CLI de Azure (versión 2.30.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az devops security group. Obtenga más información sobre las extensiones.

Administrar grupos de seguridad.

Comandos

Nombre Description Tipo Estado
az devops security group create

Cree un grupo de Azure DevOps.

Extension GA
az devops security group delete

Elimine un grupo de Azure DevOps.

Extension GA
az devops security group list

Enumere todos los grupos de un proyecto o organización.

Extension GA
az devops security group membership

Administrar las pertenencias a grupos de seguridad.

Extension GA
az devops security group membership add

Agregar pertenencia.

Extension GA
az devops security group membership list

Enumerar las pertenencias de un grupo o usuario.

Extension GA
az devops security group membership remove

Quite la pertenencia.

Extension GA
az devops security group show

Mostrar los detalles del grupo.

Extension GA
az devops security group update

Actualice el nombre Y/O la descripción de un grupo de Azure DevOps.

Extension GA

az devops security group create

Cree un grupo de Azure DevOps.

az devops security group create [--description]
                                [--detect {false, true}]
                                [--email-id]
                                [--groups]
                                [--name]
                                [--org --organization]
                                [--origin-id]
                                [--project]
                                [--scope {organization, project}]

Ejemplos

Creación de un grupo de Azure DevOps con el nombre y la descripción

az devops security group create --name 'Some group name'
--description 'Something to describe this group'

Adición de un grupo de AAD existente a un grupo de Azure DevOps

Get object ID of an existing AAD group
az ad group show -g '{Group Name}'
az devops security group create --origin-id '{Object ID}' --groups 'vssgp.someDescriptorForGroup'

Adición de un grupo de AAD existente a un grupo de Azure DevOps con el identificador de correo electrónico del grupo de AAD

az devops security group create --email-id '{Email ID of AAD group}'
--groups 'vssgp.someDescriptorForGroup'

Cree un nuevo grupo de Azure DevOps y agréguelo a los grupos de Azure DevOps existentes.

az devops security group create --name 'Some group name'
--groups 'vssgp.someDescriptorForGroupOne,vssgp.someDescriptorForGroupTwo'

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--description

Descripción del grupo de Azure DevOps.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--email-id

Cree un nuevo grupo con la dirección de correo como referencia a un grupo existente desde un proveedor de AD o AAD externo respaldado. Obligatorio si falta el nombre o el identificador de origen.

--groups

Lista separada por comas de descriptores que hacen referencia a grupos que desea que se unan al grupo recién creado.

--name

Nombre del grupo de Azure DevOps.

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--origin-id

Cree un nuevo grupo con OriginID como referencia a un grupo existente desde un proveedor de AD o AAD externo respaldado. Obligatorio si falta el nombre o el identificador de correo electrónico.

--project -p

Nombre o identificador del proyecto en el que se debe crear el grupo de Azure DevOps.

--scope

Cree un grupo en el nivel de proyecto o organización.

Propiedad Valor
Valor predeterminado: project
Valores aceptados: organization, project
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az devops security group delete

Elimine un grupo de Azure DevOps.

az devops security group delete --id
                                [--detect {false, true}]
                                [--org --organization]
                                [--yes]

Parámetros requeridos

--id

Descriptor del grupo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az devops security group list

Enumere todos los grupos de un proyecto o organización.

az devops security group list [--continuation-token]
                              [--detect {false, true}]
                              [--org --organization]
                              [--project]
                              [--scope {organization, project}]
                              [--subject-types]

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--continuation-token

Si hay más resultados que no se pueden devolver en una sola página, el conjunto de resultados contendrá un token de continuación para la recuperación del siguiente conjunto de resultados.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Enumera los grupos de un proyecto determinado.

--scope

Enumera los grupos en el nivel de proyecto o organización.

Propiedad Valor
Valor predeterminado: project
Valores aceptados: organization, project
--subject-types

Lista separada por comas de subtipos de asunto de usuario para reducir los resultados recuperados. Puede asignar una parte inicial del descriptor [antes del punto] como filtro, por ejemplo, vssgp,aadgp.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az devops security group show

Mostrar los detalles del grupo.

az devops security group show --id
                              [--detect {false, true}]
                              [--org --organization]

Parámetros requeridos

--id

Descriptor del grupo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az devops security group update

Actualice el nombre Y/O la descripción de un grupo de Azure DevOps.

az devops security group update --id
                                [--description]
                                [--detect {false, true}]
                                [--name]
                                [--org --organization]

Parámetros requeridos

--id

Descriptor del grupo.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--description

Nueva descripción del grupo de Azure DevOps.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--name

Nuevo nombre para el grupo de Azure DevOps.

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False