Update-AzConfig
Azure PowerShell의 구성을 업데이트합니다.
구문
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"입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CheckForUpgrade
사용하도록 설정하면 Azure PowerShell에서 업데이트를 자동으로 확인하고 업데이트를 사용할 수 있을 때 힌트 메시지를 표시합니다. 기본값은 true입니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
| 형식: | IAzureContextContainer |
| 별칭: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultSubscriptionForLogin
구독 이름 또는 GUID입니다. 구독을 지정하지 않고 로그인할 때 Azure PowerShell의 기본 컨텍스트를 설정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DisableErrorRecordsPersistence
사용하지 않도록 설정하면 오류 레코드가 ~/에 기록되지 않습니다. Azure/ErrorRecords. 이 구성은 2023년 11월경 Az의 다음 주요 릴리스에서 옵트인으로 "EnableErrorRecordsPersistence"로 대체됩니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DisableInstanceDiscovery
인스턴스 검색 및 권한 유효성 검사를 모두 사용하지 않도록 설정하려면 true로 설정합니다. 이 기능은 프라이빗 클라우드 또는 Azure Stack과 같이 메타데이터 엔드포인트에 연결할 수 없는 시나리오에서 사용하기 위한 것입니다. 인스턴스 검색 프로세스는 인증 기관의 유효성을 검사하기 위해 기관 메타데이터 https://login.microsoft.com/ 를 검색해야 합니다. 이를 true로 설정하면 권한의 유효성 검사가 비활성화됩니다. 따라서 구성된 기관 호스트가 유효하고 신뢰할 수 있는지 확인하는 것이 중요합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DisplayBreakingChangeWarning
주요 변경 내용에 대한 경고 메시지가 표시되거나 표시되지 않는지 여부를 제어합니다. 사용하도록 설정하면 이후 릴리스에서 호환성이 손상되는 변경 내용이 포함된 cmdlet을 실행할 때 호환성이 손상되는 변경 경고가 표시됩니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DisplayRegionIdentified
사용하도록 설정하면 Azure PowerShell은 비용을 절감할 수 있는 지역에 대한 권장 사항을 표시합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DisplaySecretsWarning
사용하도록 설정하면 cmdlet 출력에 비밀이 포함된 경우 경고 메시지가 표시됩니다. https://go.microsoft.com/fwlink/?linkid=2258844에서 자세히 알아보세요.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-DisplaySurveyMessage
사용하도록 설정하면 Azure PowerShell에 대한 사용자 환경 설문 조사에 자주 참여하라는 메시지가 자주 표시되지 않습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EnableDataCollection
사용하도록 설정하면 Azure PowerShell cmdlet은 고객 환경을 개선하기 위해 원격 분석 데이터를 Microsoft에 보냅니다. 자세한 내용은 개인정보취급방침 참조하세요. https://aka.ms/privacy
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-EnableLoginByWam
[미리 보기] 사용하도록 설정하면 WAM(웹 계정 관리자)이 기본 대화형 로그인 환경이 됩니다. 플랫폼이 WAM을 지원하지 않는 경우 브라우저 사용으로 대체됩니다. 이 기능은 미리 보기로 제공됩니다. MSA(Microsoft 계정)는 현재 지원되지 않습니다. 피드백이 있는 경우 Azure PowerShell 팀에 자유롭게 연락하세요. https://aka.ms/azpsissue
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Scope
구성 변경 범위(예: 변경 내용이 현재 프로세스에만 적용되는지 또는 이 사용자가 시작한 모든 세션에만 적용되는지 여부)를 결정합니다. 기본적으로 CurrentUser입니다.
| 형식: | ConfigScope |
| 허용되는 값: | CurrentUser, Process, Default, Environment |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |