Update-AzConfig
Azure PowerShell의 구성을 업데이트합니다.
구문
Update-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-CheckForUpgrade <Boolean>]
[-DefaultSubscriptionForLogin <String>]
[-DisableInstanceDiscovery <Boolean>]
[-DisplayBreakingChangeWarning <Boolean>]
[-DisplayRegionIdentified <Boolean>]
[-DisplaySecretsWarning <Boolean>]
[-DisplaySurveyMessage <Boolean>]
[-EnableDataCollection <Boolean>]
[-EnableErrorRecordsPersistence <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 |
-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 |
-EnableErrorRecordsPersistence
사용하도록 설정하면 오류 레코드가 ~/에 기록됩니다. Azure/ErrorRecords.
| 형식: | 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 |
-LoginExperienceV2
대화형으로 인증할 때만 활성 상태이면 사용자가 후속 명령에 사용되는 구독 및 테넌트를 선택할 수 있습니다. 가능한 값 광고 'On'(기본값) 및 '끄기'입니다. 'On'에는 사용자의 입력이 필요합니다. 'Off'는 Azure에서 반환된 첫 번째 테넌트 및 구독을 사용하고, 예고 없이 변경될 수 있으며, 원치 않는 컨텍스트에서 명령 실행으로 이어질 수 있습니다(권장되지 않음).
| 형식: | LoginExperienceConfig |
| 허용되는 값: | On, Off |
| 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 |
입력
출력
Azure PowerShell