Get-AzConfig

Obtiene las configuraciones de Azure PowerShell.

Syntax

Get-AzConfig
   [-AppliesTo <String>]
   [-Scope <ConfigScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-CheckForUpgrade]
   [-DefaultSubscriptionForLogin]
   [-DisableErrorRecordsPersistence]
   [-DisableInstanceDiscovery]
   [-DisplayBreakingChangeWarning]
   [-DisplayRegionIdentified]
   [-DisplaySurveyMessage]
   [-EnableDataCollection]
   [-EnableLoginByWam]
   [<CommonParameters>]

Description

Obtiene las configuraciones de Azure PowerShell. De forma predeterminada, enumera todas las configuraciones. Puede filtrar el resultado mediante varios parámetros.

Nota:

Las configuraciones tienen prioridades. En términos generales, el ámbito de proceso tiene mayor prioridad que el ámbito CurrentUser; Una configuración que se aplica a un determinado cmdlet tiene una prioridad más alta que la que se aplica a un módulo, de nuevo superior a Az. Para reducir la confusión, el resultado de Get-AzConfig muestra las configuraciones que surten efecto. Es una combinación de todas las configuraciones, pero no literalmente todas las configuraciones. Sin embargo, siempre puede verlos aplicando parámetros de filtro diferentes, como -Scope.

Ejemplos

Ejemplo 1

Get-AzConfig

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…
DefaultSubscriptionForLogin         Az         Default     Subscription name or GUID. Sets the default context for Azure PowerShell when logging in with…
DisplayBreakingChangeWarning  True  Az         Default     Controls if warning messages for breaking changes are displayed or suppressed. When enabled, …

Obtiene todas las configuraciones.

Ejemplo 2

Get-AzConfig -EnableDataCollection

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…

Obtiene la configuración "EnableDataCollection".

Parámetros

-AppliesTo

Especifica a qué parte de Azure PowerShell se aplica la configuración. Los valores posibles son:

  • "Az": la configuración se aplica a todos los módulos y cmdlets de Azure PowerShell.
  • Nombre del módulo: la configuración se aplica a un determinado módulo de Azure PowerShell. Por ejemplo, "Az.Storage".
  • Nombre del cmdlet: la configuración se aplica a un determinado cmdlet de Azure PowerShell. Por ejemplo, "Get-AzKeyVault". Si no se especifica, al obtener o borrar configuraciones, el valor predeterminado es todo lo anterior; al actualizar, el valor predeterminado es "Az".
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

Cuando se habilita, Azure PowerShell comprobará las actualizaciones automáticamente y mostrará un mensaje de sugerencia cuando haya una actualización disponible. El valor predeterminado es true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultSubscriptionForLogin

Nombre de la suscripción o GUID. Establece el contexto predeterminado para Azure PowerShell al iniciar sesión sin especificar ninguna suscripción.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableErrorRecordsPersistence

Cuando está deshabilitado, los registros de error no se escribirán en ~/. Azure/ErrorRecords. Esta configuración se reemplazará por "EnableErrorRecordsPersistence" como participación en la próxima versión principal de Az alrededor de noviembre de 2023.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableInstanceDiscovery

Establézcalo en true para deshabilitar la detección de instancias y la validación de autoridad. Esta funcionalidad está pensada para su uso en escenarios en los que no se puede acceder al punto de conexión de metadatos, como en nubes privadas o Azure Stack. El proceso de detección de instancias implica recuperar metadatos de autoridad de https://login.microsoft.com/ para validar la autoridad. Al establecer esto en true, la validación de la autoridad está deshabilitada. Como resultado, es fundamental asegurarse de que el host de autoridad configurado sea válido y de confianza.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayBreakingChangeWarning

Controla si se muestran o suprimen los mensajes de advertencia para los cambios importantes. Cuando se habilita, se muestra una advertencia de cambio importante al ejecutar cmdlets con cambios importantes en una versión futura.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayRegionIdentified

Cuando está habilitada, Azure PowerShell muestra recomendaciones sobre las regiones que pueden reducir los costos.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySecretsWarning

Cuando se habilita, se mostrará un mensaje de advertencia cuando la salida del cmdlet contenga secretos. Más información en https://go.microsoft.com/fwlink/?linkid=2258844.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySurveyMessage

Cuando se habilita, se le pedirá que participe con poca frecuencia en encuestas de experiencia del usuario para Azure PowerShell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableDataCollection

Cuando se habilita, los cmdlets de Azure PowerShell envían datos de telemetría a Microsoft para mejorar la experiencia del cliente. Para obtener más información, consulte nuestra declaración de privacidad: https://aka.ms/privacy

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableLoginByWam

[Versión preliminar] Cuando se habilita, el Administrador de cuentas web (WAM) será la experiencia de inicio de sesión interactiva predeterminada. Se revertirá al uso del explorador si la plataforma no admite WAM. Tenga en cuenta que esta característica está en versión preliminar. La cuenta Microsoft (MSA) no se admite actualmente. No dude en ponerse en contacto con el equipo de Azure PowerShell si tiene comentarios: https://aka.ms/azpsissue

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Determina el ámbito de los cambios de configuración, por ejemplo, si los cambios solo se aplican al proceso actual o a todas las sesiones iniciadas por este usuario. De forma predeterminada, es CurrentUser.

Type:ConfigScope
Accepted values:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

PSConfig