다음을 통해 공유


Clear-AzConfig

사용자가 설정한 구성 값을 지웁니다.

구문

Clear-AzConfig
     [-Force]
     [-PassThru]
     [-AppliesTo <String>]
     [-Scope <ConfigScope>]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-AzConfig
     [-PassThru]
     [-AppliesTo <String>]
     [-Scope <ConfigScope>]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [-CheckForUpgrade]
     [-DefaultSubscriptionForLogin]
     [-DisableInstanceDiscovery]
     [-DisplayBreakingChangeWarning]
     [-DisplayRegionIdentified]
     [-DisplaySecretsWarning]
     [-DisplaySurveyMessage]
     [-EnableDataCollection]
     [-EnableErrorRecordsPersistence]
     [-EnableLoginByWam]
     [-LoginExperienceV2]
     [<CommonParameters>]

Description

사용자가 설정한 구성 값을 지웁니다. 기본적으로 모든 구성은 지워지게 됩니다. 지울 구성의 키를 지정할 수도 있습니다.

예제

예 1

Clear-AzConfig -Force

모든 구성을 지웁다. -Force 는 확인 프롬프트를 표시하지 않습니다.

예제 2

Clear-AzConfig -EnableDataCollection

"EnableDataCollection" 구성을 지웁니다.

매개 변수

-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입니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용: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의 기본 컨텍스트를 설정합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableInstanceDiscovery

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisplayBreakingChangeWarning

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisplayRegionIdentified

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisplaySecretsWarning

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisplaySurveyMessage

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EnableDataCollection

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EnableErrorRecordsPersistence

사용하도록 설정하면 오류 레코드가 ~/에 기록됩니다. Azure/ErrorRecords.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EnableLoginByWam

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

모든 구성을 지울 때 확인을 요청하지 마세요.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LoginExperienceV2

대화형으로 인증할 때만 활성 상태이면 사용자가 후속 명령에 사용되는 구독 및 테넌트를 선택할 수 있습니다. 가능한 값 광고 'On'(기본값) 및 '끄기'입니다. 'On'에는 사용자의 입력이 필요합니다. 'Off'는 Azure에서 반환된 첫 번째 테넌트 및 구독을 사용하고, 예고 없이 변경될 수 있으며, 원치 않는 컨텍스트에서 명령 실행으로 이어질 수 있습니다(권장되지 않음).

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

cmdlet이 올바르게 실행되면 true를 반환합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용: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

입력

None

출력

Boolean