Aracılığıyla paylaş


Update-AzConfig

Azure PowerShell'in yapılandırmalarını güncelleştirir.

Sözdizimi

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'in yapılandırmalarını güncelleştirir. Güncelleştirilecek yapılandırmaya bağlı olarak, yapılandırmanın kalıcı olduğu kapsamı ve uygulanacağı modülü veya cmdlet'i belirtebilirsiniz.

Not

Birden çok PowerShell işlemindeki yapılandırmaları güncelleştirmek önerilmez. Bunu tek bir işlemde yapın veya beklenmeyen yan etkilerden kaçınmak için güncelleştirmelerin İşlem kapsamında (-Scope Process) olduğundan emin olun.

Örnekler

Örnek 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" yapılandırmasını "Aboneliğin adı" olarak ayarlar. Connect-AzAccount Belirtilen abonelik varsayılan abonelik olarak seçileceği zaman.

Örnek 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,…

"Az.KeyVault" modülü için "DisplayBreakingChangeWarnings" yapılandırmasını "$false" olarak ayarlar. Bu, Az.KeyVault modülünde yaklaşan hataya neden olan değişiklikler için tüm uyarı iletilerinin sorulmasını engeller.

Örnek 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" yapılandırmasını "$true" olarak ayarlar. Bu, telemetri verilerinin gönderilmesini sağlar. Bu yapılandırmanın ayarlanması ve Disable-AzDataCollectionile Enable-AzDataCollection eşdeğerdir.

Örnek 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" yapılandırmasını "$true" olarak ayarlar. Bu, cmdlet yürütmesi sırasında gizli dizi algılamayı etkinleştirir ve çıktıda gizli diziler bulunursa bir uyarı iletisi görüntüler.

Parametreler

-AppliesTo

Yapılandırmanın Azure PowerShell'in hangi bölümü için geçerli olduğunu belirtir. Olası değerler şunlardır:

  • "Az": yapılandırma, Azure PowerShell'in tüm modülleri ve cmdlet'leri için geçerlidir.
  • Modül adı: Yapılandırma, Azure PowerShell'in belirli bir modülü için geçerlidir. Örneğin, "Az.Storage".
  • Cmdlet adı: Yapılandırma, Azure PowerShell'in belirli bir cmdlet'ine uygulanır. Örneğin, "Get-AzKeyVault". Belirtilmezse, yapılandırmaları alırken veya temizlerken varsayılan olarak yukarıdakilerin tümüne; güncelleştirme sırasında varsayılan olarak "Az" olur.
Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CheckForUpgrade

Etkinleştirildiğinde, Azure PowerShell güncelleştirmeleri otomatik olarak denetler ve bir güncelleştirme kullanılabilir olduğunda bir ipucu iletisi görüntüler. Varsayılan değer doğru'dur.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:IAzureContextContainer
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultSubscriptionForLogin

Abonelik adı veya GUID. Abonelik belirtmeden oturum açarken Azure PowerShell için varsayılan bağlamı ayarlar.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisableInstanceDiscovery

Hem örnek bulma hem de yetkili doğrulamasını devre dışı bırakmak için true olarak ayarlayın. Bu işlev, meta veri uç noktasına erişilemeyen özel bulutlar veya Azure Stack gibi senaryolarda kullanılmak üzere tasarlanmıştır. Örnek bulma işlemi, yetkiliyi doğrulamak için yetkili meta verilerinin alınmasına https://login.microsoft.com/ neden olabilir. Bunu true olarak ayarlayarak, yetkilinin doğrulaması devre dışı bırakılır. Sonuç olarak, yapılandırılan yetkili konağın geçerli ve güvenilir olduğundan emin olmak çok önemlidir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisplayBreakingChangeWarning

Hataya neden olan değişiklikler için uyarı iletilerinin görüntülenip görüntülenmediğini veya gizlenip gösterilmediğini denetler. Etkinleştirildiğinde, gelecek bir sürümde hataya neden olan değişiklikler içeren cmdlet'ler yürütülürken hataya neden olan bir değişiklik uyarısı görüntülenir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisplayRegionIdentified

Etkinleştirildiğinde Azure PowerShell, maliyetlerinizi düşürebilecek bölgelere ilişkin öneriler görüntüler.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisplaySecretsWarning

Etkinleştirildiğinde, cmdlet çıkışı gizli diziler içerdiğinde bir uyarı iletisi görüntülenir. Daha fazla bilgi için: https://go.microsoft.com/fwlink/?linkid=2258844

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DisplaySurveyMessage

Etkinleştirildiğinde, Azure PowerShell için kullanıcı deneyimi anketlerine nadiren katılmanız istenir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EnableDataCollection

Etkinleştirildiğinde, Azure PowerShell cmdlet'leri müşteri deneyimini geliştirmek için Microsoft'a telemetri verileri gönderir. Daha fazla bilgi için gizlilik bildirimimize bakın: https://aka.ms/privacy

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EnableErrorRecordsPersistence

Etkinleştirildiğinde hata kayıtları ~/ olarak yazılır. Azure/ErrorRecords.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-EnableLoginByWam

[Önizleme] Etkinleştirildiğinde, Web Hesabı Yöneticisi (WAM) varsayılan etkileşimli oturum açma deneyimi olacaktır. Platform WAM'yi desteklemiyorsa tarayıcıyı kullanmaya geri döner. Bu özelliğin önizleme aşamasında olduğunu unutmayın. Microsoft Hesabı (MSA) şu anda desteklenmiyor. Geri bildirimleriniz varsa Azure PowerShell ekibine ulaşmaktan çekinmeyin: https://aka.ms/azpsissue

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-LoginExperienceV2

Yalnızca etkileşimli kimlik doğrulaması yaparken etkin olması, kullanıcının sonraki komutlarda kullanılan aboneliği ve kiracıyı seçmesine izin verir. 'Açık' (Varsayılan) ve 'Kapalı' olası değerleri. 'Açık', kullanıcının girişini gerektirir. 'Kapalı', Azure tarafından döndürülen ilk kiracıyı ve aboneliği kullanır, bildirimde bulunmadan değişebilir ve istenmeyen bir bağlamda komut yürütülmesine yol açabilir (önerilmez).

Tür:LoginExperienceConfig
Kabul edilen değerler:On, Off
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Scope

Yapılandırma değişikliklerinin kapsamını belirler; örneğin, değişikliklerin yalnızca geçerli işleme mi yoksa bu kullanıcı tarafından başlatılan tüm oturumlara mı uygulanacağını belirler. Varsayılan olarak CurrentUser'dır.

Tür:ConfigScope
Kabul edilen değerler:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

Boolean

String

Çıkışlar

PSConfig