az devops service-endpoint

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 service-endpoint. Obtenga más información sobre las extensiones.

Administrar puntos de conexión o conexiones de servicio.

Comandos

Nombre Description Tipo Estado
az devops service-endpoint azurerm

Administre Azure puntos de conexión o conexiones del servicio RM.

 Extension GA
az devops service-endpoint azurerm create

Cree un punto de conexión de servicio de tipo RM de Azure.

 Extension GA
az devops service-endpoint convert

Convierta un punto de conexión de servicio para usar credenciales federadas externas.

 Extension GA
az devops service-endpoint create

Cree un punto de conexión de servicio mediante el archivo de configuración.

 Extension GA
az devops service-endpoint delete

Elimina el punto de conexión de servicio.

 Extension GA
az devops service-endpoint github

Administrar GitHub puntos de conexión o conexiones de servicio.

 Extension GA
az devops service-endpoint github create

Cree un punto de conexión de servicio GitHub.

 Extension GA
az devops service-endpoint list

Enumeración de puntos de conexión de servicio en un proyecto.

 Extension GA
az devops service-endpoint show

Obtenga los detalles de un punto de conexión de servicio.

 Extension GA
az devops service-endpoint update

Actualice un punto de conexión de servicio.

 Extension GA

az devops service-endpoint convert

Convierta un punto de conexión de servicio para usar credenciales federadas externas.

Envía una solicitud de migración al Azure DevOps API de migración de credenciales federadas externas para la conexión de servicio especificada a través de --azdo-subject. El valor --azdo-subject debe estar en sc://<organization>/<project>/<serviceConnectionName> formato. La dirección URL de la organización se deriva automáticamente de --azdo-subject mediante https://dev.azure.com. Use --tenant-id para seleccionar el inquilino entra usado para autenticarse en la organización de Azure DevOps.

az devops service-endpoint convert --azdo-subject
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--tenant-id]

Ejemplos

Conversión mediante solo la conexión de servicio (la organización se deriva automáticamente)

az devops service-endpoint convert --azdo-subject "sc://myorg/myproject/myserviceconnection"

Conversión mediante un inquilino de autenticación específico

az devops service-endpoint convert --azdo-subject "sc://myorg/myproject/myserviceconnection" --tenant-id "00000000-0000-0000-0000-000000000000"

Parámetros requeridos

--azdo-subject

El sujeto de credenciales federadas del emisor de Azure DevOps, en sc://<organization>/<project>/<serviceConnectionName> formato. La dirección URL de la organización se deriva de --azdo-subject mediante https://dev.azure.com.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--tenant-id

Id. de inquilino de Entra que se usa para autenticarse en la organización de Azure DevOps. El valor predeterminado es el inquilino de suscripción predeterminado o el primer inquilino de suscripción en caché.

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 service-endpoint create

Cree un punto de conexión de servicio mediante el archivo de configuración.

Puede obtener más información sobre esto en https://aka.ms/azure-devops-service-endpoint-config.

az devops service-endpoint create --service-endpoint-configuration
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--detect {false, true}]
                                  [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                                  [--org --organization]
                                  [--project]

Parámetros requeridos

--service-endpoint-configuration

Archivo de configuración con solicitud de punto de conexión de servicio.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--encoding

Codificación del archivo de entrada.

Propiedad Valor
Valor predeterminado: utf-8
Valores aceptados: ascii, utf-16be, utf-16le, utf-8
--org --organization

Azure DevOps dirección URL de la organización. 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

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

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 service-endpoint delete

Elimina el punto de conexión de servicio.

az devops service-endpoint delete --id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--deep]
                                  [--detect {false, true}]
                                  [--org --organization]
                                  [--project]
                                  [--yes]

Parámetros requeridos

--id

Identificador del punto de conexión de servicio que se va a eliminar.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--deep

Específico del punto de conexión de AzureRM creado en Flujo automático. Cuando se especifica, también se eliminará la aplicación de AAD correspondiente en Azure.

Propiedad Valor
Valor predeterminado: False
--detect

Detectar automáticamente la organización.

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

Azure DevOps dirección URL de la organización. 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

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--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 service-endpoint list

Enumeración de puntos de conexión de servicio en un proyecto.

:rtype: lista de :class:VssJsonCollectionWrapper <service_endpoint.v4_1.models.ServiceEndpoint>.

az devops service-endpoint list [--detect {false, true}]
                                [--org --organization]
                                [--project]

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

Azure DevOps dirección URL de la organización. 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

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

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 service-endpoint show

Obtenga los detalles de un punto de conexión de servicio.

az devops service-endpoint show --id
                                [--detect {false, true}]
                                [--org --organization]
                                [--project]

Parámetros requeridos

--id

Identificador del punto de conexión de servicio.

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

Azure DevOps dirección URL de la organización. 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

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

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 service-endpoint update

Actualice un punto de conexión de servicio.

az devops service-endpoint update --id
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--detect {false, true}]
                                  [--enable-for-all {false, true}]
                                  [--org --organization]
                                  [--project]

Parámetros requeridos

--id

Identificador del punto de conexión de servicio.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--enable-for-all

Permitir que todas las canalizaciones accedan a este punto de conexión de servicio.

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

Azure DevOps dirección URL de la organización. 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

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

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