Update-AzConfig

Azure PowerShell의 구성을 업데이트.

Syntax

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

Description

Azure PowerShell의 구성을 업데이트. 업데이트할 구성에 따라 구성이 유지되는 범위와 해당 구성이 적용되는 모듈 또는 cmdlet을 지정할 수 있습니다.

참고 항목

여러 PowerShell 프로세스에서 구성을 업데이트하는 것이 좋습니다. 한 프로세스에서 수행하거나 예기치 않은 부작용을 방지하기 위해 업데이트가 프로세스 범위(-Scope Process)에 있는지 확인합니다.

예제

예 1

Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"

Key                         Value                Applies To Scope       Help Message
---                         -----                ---------- -----       ------------
DefaultSubscriptionForLogin Name of subscription Az         CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…

"DefaultSubscriptionForLogin" 구성을 "구독 이름"으로 설정합니다. Connect-AzAccount 지정된 구독이 기본 구독으로 선택되는 경우

예제 2

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"

Key                          Value Applies To  Scope       Help Message
---                          ----- ----------  -----       ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…

"DisplayBreakingChangeWarnings" 구성을 "Az.KeyVault" 모듈의 "$false"로 설정합니다. 이렇게 하면 Az.KeyVault 모듈에서 예정된 호환성이 손상되는 변경에 대한 모든 경고 메시지가 메시지를 표시하지 않습니다.

예 3

Update-AzConfig -EnableDataCollection $true

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

"EnableDataCollection" 구성을 "$true"로 설정합니다. 이렇게 하면 원격 분석 데이터를 보낼 수 있습니다. 이 구성을 설정하는 것은 동일합니다Enable-AzDataCollection.Disable-AzDataCollection

예시 4

Update-AzConfig -DisplaySecretsWarning $true

Key                   Value Applies To Scope       Help Message
---                   ----- ---------- -----       ------------
DisplaySecretsWarning True  Az         CurrentUser When enabled, a warning message for secrets redaction will be displ…

"DisplaySecretsWarning" 구성을 "$true"로 설정합니다. 이렇게 하면 cmdlet을 실행하는 동안 비밀 검색이 가능하며 출력에 비밀이 있으면 경고 메시지가 표시됩니다.

매개 변수

-AppliesTo

구성이 적용되는 Azure PowerShell의 일부를 지정합니다. 가능한 값은 다음과 같습니다.

  • "Az": 구성은 Azure PowerShell의 모든 모듈 및 cmdlet에 적용됩니다.
  • 모듈 이름: 구성은 Azure PowerShell의 특정 모듈에 적용됩니다. 예를 들어 "Az.Storage"입니다.
  • Cmdlet 이름: 구성은 Azure PowerShell의 특정 cmdlet에 적용됩니다. 예를 들어 "Get-AzKeyVault"입니다. 지정하지 않으면 구성을 가져오거나 지울 때 기본값은 위의 모든 항목으로 설정됩니다. 업데이트할 때 기본값은 "Az"입니다.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

사용하도록 설정하면 Azure PowerShell은 업데이트를 자동으로 검사 업데이트를 사용할 수 있을 때 힌트 메시지를 표시합니다. 기본값은 true입니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-DefaultSubscriptionForLogin

구독 이름 또는 GUID입니다. 구독을 지정하지 않고 로그인할 때 Azure PowerShell의 기본 컨텍스트를 설정합니다.

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

-DisableErrorRecordsPersistence

사용하지 않도록 설정하면 오류 레코드가 ~/에 기록되지 않습니다. Azure/ErrorRecords. 이 구성은 2023년 11월경 Az의 다음 주요 릴리스에서 옵트인으로 "EnableErrorRecordsPersistence"로 대체됩니다.

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

-DisableInstanceDiscovery

인스턴스 검색 및 권한 유효성 검사를 모두 사용하지 않도록 설정하려면 true로 설정합니다. 이 기능은 프라이빗 클라우드 또는 Azure Stack과 같이 메타데이터 엔드포인트에 연결할 수 없는 시나리오에서 사용하기 위한 것입니다. 인스턴스 검색 프로세스는 인증 기관의 유효성을 검사하기 위해 기관 메타데이터 https://login.microsoft.com/ 를 검색해야 합니다. 이를 true로 설정하면 권한의 유효성 검사가 비활성화됩니다. 따라서 구성된 기관 호스트가 유효하고 신뢰할 수 있는지 확인하는 것이 중요합니다.

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

-DisplayBreakingChangeWarning

주요 변경 내용에 대한 경고 메시지가 표시되거나 표시되지 않는지 여부를 제어합니다. 사용하도록 설정하면 이후 릴리스에서 호환성이 손상되는 변경 내용이 포함된 cmdlet을 실행할 때 호환성이 손상되는 변경 경고가 표시됩니다.

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

-DisplayRegionIdentified

사용하도록 설정하면 Azure PowerShell은 비용을 절감할 수 있는 지역에 대한 권장 사항을 표시합니다.

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

-DisplaySecretsWarning

사용하도록 설정하면 cmdlet 출력에 비밀이 포함된 경우 경고 메시지가 표시됩니다. https://go.microsoft.com/fwlink/?linkid=2258844에서 자세히 알아보세요.

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

-DisplaySurveyMessage

사용하도록 설정하면 Azure PowerShell에 대한 사용자 환경 설문 조사에 자주 참여하라는 메시지가 자주 표시되지 않습니다.

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

-EnableDataCollection

사용하도록 설정하면 Azure PowerShell cmdlet은 고객 환경을 개선하기 위해 원격 분석 데이터를 Microsoft에 보냅니다. 자세한 내용은 개인정보처리방침을 참조하세요. https://aka.ms/privacy

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

-EnableLoginByWam

[미리 보기] 사용하도록 설정하면 WAM(웹 계정 관리자)이 기본 대화형 로그인 환경이 됩니다. 플랫폼이 WAM을 지원하지 않는 경우 브라우저 사용으로 대체됩니다. 이 기능은 미리 보기로 제공됩니다. MSA(Microsoft 계정)는 현재 지원되지 않습니다. 피드백이 있는 경우 Azure PowerShell 팀에 자유롭게 연락하세요. https://aka.ms/azpsissue

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

-Scope

구성 변경 범위(예: 변경 내용이 현재 프로세스에만 적용되는지 또는 이 사용자가 시작한 모든 세션에만 적용되는지 여부)를 결정합니다. 기본적으로 CurrentUser입니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

Boolean

String

출력

PSConfig