Update-AzConfig

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

Syntax

Default (Varsayılan)

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 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.

Note

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 Enable-AzDataCollectionile Disable-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 hangi Azure PowerShell uygulanacağı belirtir. Olası değerler şunlardır:

  • "Az": yapılandırma, Azure PowerShell tüm modülleri ve cmdlet'leri için geçerlidir.
  • Modül adı: Yapılandırma, belirli bir Azure PowerShell modülü için geçerlidir. Örneğin, "Az.Storage".
  • Cmdlet adı: Yapılandırma, belirli bir Azure PowerShell cmdlet'i için geçerlidir. Ö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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Confirm

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultProfile

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

Parametre özellikleri

Tür:IAzureContextContainer
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:AzContext, AzureRmContext, AzureCredential

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-DefaultSubscriptionForLogin

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-DisableInstanceDiscovery

Hem örnek bulma hem de yetkili doğrulamasını devre dışı bırakmak için true olarak ayarlayın. Bu işlevsellik, metaveri uç noktasına erişilemeyen durumlarda, örneğin özel bulutlarda veya Azure Stack'te 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.

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-DisplayRegionIdentified

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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-DisplaySurveyMessage

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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-EnableDataCollection

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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-EnableErrorRecordsPersistence

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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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

Parametre özellikleri

Tür:Boolean
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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).

Parametre özellikleri

Tür:LoginExperienceConfig
Default value:None
Kabul edilen değerler:On, Off
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:ConfigScope
Default value:None
Kabul edilen değerler:CurrentUser, Process, Default, Environment
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

Boolean

String

Çıkışlar

PSConfig