Sorun giderme & sınırlamaları Azure Cloud ShellTroubleshooting & Limitations of Azure Cloud Shell

Azure Cloud shell'de sorunları gidermek için bilinen çözümleri şunlardır:Known resolutions for troubleshooting issues in Azure Cloud Shell include:

Not

Bu makale yeni Azure PowerShell Az modülünü kullanacak şekilde güncelleştirilmiştir.This article has been updated to use the new Azure PowerShell Az module. En azından Aralık 2020'ye kadar hata düzeltmeleri almaya devam edecek olan AzureRM modülünü de kullanmaya devam edebilirsiniz.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Yeni Az modülüyle AzureRM'nin uyumluluğu hakkında daha fazla bilgi edinmek için bkz. Yeni Azure PowerShell Az modülüne giriş.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az modülü yükleme yönergeleri için bkz. Azure PowerShell'i yükleme.For Az module installation instructions, see Install Azure PowerShell.

Genel sorun gidermeGeneral troubleshooting

FireFox erken zaman aşımlarıEarly timeouts in FireFox

  • Ayrıntılar: Cloud Shell'i tarayıcınıza giriş/çıkış geçirmek için açık bir websocket kullanır.Details: Cloud Shell utilizes an open websocket to pass input/output to your browser. FireFox beklenenden önce Cloud Shell'de erken zaman aşımları neden websocket kapatabilirsiniz hazır ilkeleri vardır.FireFox has preset policies that can close the websocket prematurely causing early timeouts in Cloud Shell.
  • Çözüm: FireFox açın ve gidin "hakkında: yapılandırma" URL kutusuna.Resolution: Open FireFox and navigate to "about:config" in the URL box. "Network.websocket.timeout.ping.request" için arama yapın ve değeri 0 ile 10'a değiştirin.Search for "network.websocket.timeout.ping.request" and change the value from 0 to 10.

Cloud Shell kilitli bir ağda devre dışı ortamDisabling Cloud Shell in a locked down network environment

  • Ayrıntılar: Yöneticileri, kullanıcıları için Cloud Shell erişimi devre dışı bırakmak isteyebilir.Details: Administrators may wish to disable access to Cloud Shell for their users. Cloud shell'e erişim için yararlanan ux.console.azure.com etki alanı durdurma portal.azure.com, shell.azure.com, Visual Studio Code Azure hesabı uzantısı ve docs.microsoft.com dahil olmak üzere Cloud Shell'inizin giriş noktaları için herhangi bir erişim engellenebilir.Cloud Shell utilizes access to the ux.console.azure.com domain which can be denied, stopping any access to Cloud Shell's entrypoints including portal.azure.com, shell.azure.com, Visual Studio Code Azure Account extension, and docs.microsoft.com.
  • Çözüm: Erişimi kısıtlamak ux.console.azure.com ortamınızdaki ağ ayarları aracılığıyla.Resolution: Restrict access to ux.console.azure.com via network settings to your environment. Cloud Shell simgesi portal.azure.com içinde var olmaya devam edecek, ancak başarıyla hizmetine bağlanamaz.The Cloud Shell icon will still exist in portal.azure.com, but will not successfully connect to the service.

Depolama iletişim - hata: 403 RequestDisallowedByPolicyStorage Dialog - Error: 403 RequestDisallowedByPolicy

  • Ayrıntılar: Cloud Shell aracılığıyla bir depolama hesabı oluştururken, yöneticiniz tarafından yerleştirilen bir Azure ilkesi nedeniyle başarısız olur Hata iletisi içerir: The resource action 'Microsoft.Storage/storageAccounts/write' is disallowed by one or more policies.Details: When creating a storage account through Cloud Shell, it is unsuccessful due to an Azure policy placed by your admin. Error message will include: The resource action 'Microsoft.Storage/storageAccounts/write' is disallowed by one or more policies.
  • Çözüm: Kaldırın veya depolama oluşturma reddetme Azure İlkesi güncelleştirmek için Azure yöneticinize başvurun.Resolution: Contact your Azure administrator to remove or update the Azure policy denying storage creation.

Depolama iletişim - hata: 400 DisallowedOperationStorage Dialog - Error: 400 DisallowedOperation

  • Ayrıntılar: Azure Active Directory aboneliğinin kullanırken, depolama oluşturulamıyor.Details: When using an Azure Active Directory subscription, you cannot create storage.
  • Çözüm: Depolama kaynaklarını istemcilerinizle Azure aboneliği kullanın.Resolution: Use an Azure subscription capable of creating storage resources. Azure AD abonelikleri Azure kaynaklarını oluşturmak mümkün değildir.Azure AD subscriptions are not able to create Azure resources.

Terminal çıktısını - hata: Terminal bağlanılamadı: websocket bağlantısı kurulamadı.Terminal output - Error: Failed to connect terminal: websocket cannot be established. Tuşuna Enter bağlanmayı.Press Enter to reconnect.

  • Ayrıntılar: Cloud Shell'i Cloud Shell altyapı websocket bağlantısı gerektirir.Details: Cloud Shell requires the ability to establish a websocket connection to Cloud Shell infrastructure.
  • Çözüm: Ağ ayarlarınızı gönderen https isteklerini ve yanıtlarını websocket konumundaki etki alanları için etkinleştirilecek şekilde yapılandırdığınız denetleyin *. console.azure.com.Resolution: Check you have configured your network settings to enable sending https requests and websocket requests to domains at *.console.azure.com.

TLS 1.2 kullanarak desteklemek için Cloud Shell bağlantınızı ayarlayınSet your Cloud Shell connection to support using TLS 1.2

  • Ayrıntılar: TLS sürümü bağlantınız için Cloud shell'e tanımlamak için belirli ayarlara ayarlamanız gerekir.Details: To define the version of TLS for your connection to Cloud Shell, you must set browser specific settings.
  • Çözüm: Tarayıcınızın güvenlik ayarlarına gidin ve "TLS 1.2 kullan" yanındaki onay kutusunu seçin.Resolution: Navigate to the security settings of your browser and select the checkbox next to "Use TLS 1.2".

Bash sorunlarını gidermeBash troubleshooting

Docker Daemon programını çalıştıramazCannot run the docker daemon

  • Ayrıntılar: Cloud Shell, kabuk ortamını barındırmak için bir kapsayıcı kullanır; sonuç olarak arka plan programı çalıştıran izin verilmiyor.Details: Cloud Shell utilizes a container to host your shell environment, as a result running the daemon is disallowed.
  • Çözüm: Yazılımınız docker-machine, uzak Docker ana bilgisayarından docker kapsayıcıları yönetmek için varsayılan olarak yüklü.Resolution: Utilize docker-machine, which is installed by default, to manage docker containers from a remote Docker host.

PowerShell sorunlarını gidermePowerShell troubleshooting

GUI uygulamaları desteklenmez.GUI applications are not supported

  • Ayrıntılar: Bir kullanıcı bir GUI uygulama başlatıldığında, istemi döndürmez.Details: If a user launches a GUI application, the prompt does not return. Örneğin, bir iki faktörlü kimlik doğrulaması etkin olan bir özel GitHub deposunu kopyaladığınızda, bir iletişim kutusu iki faktörlü kimlik doğrulamasını tamamlamak için görüntülenir.For example, when one clone a private GitHub repo that has two factor authentication enabled, a dialog box is displayed for completing the two factor authentication.
  • Çözüm: Kabuğu kapatıp yeniden açın.Resolution: Close and reopen the shell.

Azure sanal makinelerini uzaktan yönetimi sorunlarını gidermeTroubleshooting remote management of Azure VMs

Not

Azure Vm'leri bir genel IP adresi'e yönelik olmalıdır.Azure VMs must have a Public facing IP address.

  • Ayrıntılar: WinRM için varsayılan Windows Güvenlik Duvarı ayarları nedeniyle kullanıcı aşağıdaki hatayı görebilirsiniz: Ensure the WinRM service is running. Remote Desktop into the VM for the first time and ensure it can be discovered.Details: Due to the default Windows Firewall settings for WinRM the user may see the following error: Ensure the WinRM service is running. Remote Desktop into the VM for the first time and ensure it can be discovered.
  • Çözüm: Çalıştırma Enable-AzVMPSRemoting tüm yönlerini hedef makinede PowerShell uzaktan iletişimini etkinleştirmek için.Resolution: Run Enable-AzVMPSRemoting to enable all aspects of PowerShell remoting on the target machine.

dir Azure sürücüsü sonucunda güncelleştirmez.dir does not update the result in Azure drive

  • Ayrıntılar: Varsayılan olarak kullanıcı deneyimini sonuçlarını iyileştirmek için dir Azure sürücüde önbelleğe alınır.Details: By default, to optimize for user experience, the results of dir is cached in Azure drive.
  • Çözüm: Oluşturmak, güncelleştirmek veya bir Azure kaynağı kaldırmak sonra çalıştırın dir -force Azure sürücüsü sonuçları güncelleştirilecek.Resolution: After you create, update or remove an Azure resource, run dir -force to update the results in the Azure drive.

Genel sınırlamalarGeneral limitations

Azure Cloud Shell, aşağıdaki bilinen sınırlamalara sahiptir:Azure Cloud Shell has the following known limitations:

Sistem durumu ve kalıcılığıSystem state and persistence

Cloud Shell oturumunuzu sağlayan makine geçicidir ve oturumunuz için 20 dakika etkin olduktan sonra dönüştürülmeden.The machine that provides your Cloud Shell session is temporary, and it is recycled after your session is inactive for 20 minutes. Cloud Shell'i Azure dosya paylaşımını bağlanmasını gerektirir.Cloud Shell requires an Azure file share to be mounted. Sonuç olarak, aboneliğiniz Cloud shell'e erişim için depolama kaynaklarını ayarlama mümkün olması gerekir.As a result, your subscription must be able to set up storage resources to access Cloud Shell. Dikkat edilecek diğer noktalar şunlardır:Other considerations include:

  • Takılı depolamayla değişikliklerini içinde clouddrive dizin kalıcı olur.With mounted storage, only modifications within the clouddrive directory are persisted. Bash, $HOME dizin de kalıcıdır.In Bash, your $HOME directory is also persisted.
  • Azure dosya paylaşımlarını yalnızca içinde bağlanabilir, bölgeye atanan.Azure file shares can be mounted only from within your assigned region.
    • Bash hizmetinde çalıştırma env yap bölgenizi bulmak için ACC_LOCATION.In Bash, run env to find your region set as ACC_LOCATION.
  • Azure dosyaları, yalnızca yerel olarak yedekli depolama ve coğrafi olarak yedekli depolama hesaplarını destekler.Azure Files supports only locally redundant storage and geo-redundant storage accounts.

Tarayıcı desteğiBrowser support

Cloud Shell'de aşağıdaki tarayıcılardan en son sürümlerini destekler:Cloud Shell supports the latest versions of following browsers:

  • Microsoft EdgeMicrosoft Edge
  • Microsoft Internet ExplorerMicrosoft Internet Explorer
  • Google ChromeGoogle Chrome
  • Mozilla FirefoxMozilla Firefox
  • Apple SafariApple Safari
    • Safari özel modda desteklenmez.Safari in private mode is not supported.

Kopyala ve YapıştırCopy and paste

  • Windows: Ctrl-c kopyalamak için desteklenir, ancak kullanmak Shift-insert yapıştırın.Windows: Ctrl-c to copy is supported but use Shift-insert to paste.
    • FireFox/IE düzgün Pano izinleri desteklemeyebilir.FireFox/IE may not support clipboard permissions properly.
  • Mac OS: Cmd-c kopyalamak ve Cmd-v yapıştırın.Mac OS: Cmd-c to copy and Cmd-v to paste.

Kullanım sınırlarıUsage limits

Cloud Shell'de etkileşimli kullanım durumları için tasarlanmıştır.Cloud Shell is intended for interactive use cases. Sonuç olarak, herhangi bir uzun süre çalışan etkileşimli olmayan oturum uyarı vermeden sonlandırılır.As a result, any long-running non-interactive sessions are ended without warning.

Kullanıcı izinleriUser permissions

İzinleri, sudo erişimi olmadan normal kullanıcı olarak ayarlanır.Permissions are set as regular users without sudo access. Dışında herhangi bir yükleme, $Home dizin kalıcı değil.Any installation outside your $Home directory is not persisted.

Bash sınırlamalarıBash limitations

.Bashrc düzenlemeEditing .bashrc

Bunun yapılması, .bashrc düzenleme beklenmeyen hatalar Cloud Shell'de neden olabileceği zaman uyarı alın.Take caution when editing .bashrc, doing so can cause unexpected errors in Cloud Shell.

PowerShell sınırlamalarıPowerShell limitations

AzureAD modülüne Önizleme sürümüPreview version of AzureAD module

Şu anda AzureAD.Standard.Preview, .NET Standard tabanlı, modül Önizleme sürümü kullanılabilir.Currently, AzureAD.Standard.Preview, a preview version of .NET Standard-based, module is available. Bu modül aynı işlevselliği sağlar AzureAD.This module provides the same functionality as AzureAD.

SqlServer modül işleviSqlServer module functionality

SqlServer Cloud Shell'de dahil modülü PowerShell Core yalnızca yayın öncesi desteği içeriyor.The SqlServer module included in Cloud Shell has only prerelease support for PowerShell Core. Özellikle, Invoke-SqlCmd henüz kullanıma sunulmamıştır.In particular, Invoke-SqlCmd is not available yet.

Azure sürücüsünden oluşturduğunuzda varsayılan dosya konumuDefault file location when created from Azure drive

PowerShell cmdlet'lerini kullanarak, kullanıcılar Azure sürücüsü altındaki dosyalar oluşturamaz.Using PowerShell cmdlets, users cannot create files under the Azure drive. Kullanıcıların yeni dosyaları vim veya nano gibi diğer araçları kullanarak oluşturduğunuzda, dosyalar için kaydedilir $HOME varsayılan olarak.When users create new files using other tools, such as vim or nano, the files are saved to the $HOME by default.

Sekme tamamlama PSReadline durum oluşturabilirTab completion can throw PSReadline exception

Emacs için kullanıcının PSReadline EditMode ayarlarsanız, tüm olasılıkları aracılığıyla sekme tamamlama, görüntülenecek kullanıcı çalışır ve pencere boyutunu görüntüleme olanakları depolayamayacak kadar PSReadline işlenmeyen özel durum oluşturur.If the user's PSReadline EditMode is set to Emacs, the user tries to display all possibilities via tab completion, and the window size is too small to display all the possibilities, PSReadline will throw unhandled exception.

İlerleme çubuğunu görüntüleme sonra geniş boşlukLarge gap after displaying progress bar

Bir komut veya kullanıcı eyleminin bir ilerleme çubuğu, böyle bir sekme görüntüler içinde çalışırken Tamamlanıyor Azure: sürücü imleç düzgün ayarlanmamıştır ve ilerleme çubuğu daha önce olduğu boşluk görünür mümkündür.If a command or user action displays a progress bar, such a tab completing while in the Azure: drive, then it is possible that the cursor is not set properly and a gap appears where the progress bar was previously.

Satır içi rastgele karakterler görünürRandom characters appear inline

İmleç konumu dizisi kodları, örneğin 5;13R, kullanıcı girişi görünebilir.The cursor position sequence codes, for example 5;13R, can appear in the user input. Karakterler el ile kaldırılabilir.The characters can be manually removed.

Cloud shell'de kişisel verileriPersonal data in Cloud Shell

Azure Cloud Shell ciddiye kişisel verilerinizi alır, yakalanan ve Azure Cloud Shell hizmeti tarafından depolanan verileri gibi en son Kabuk kullanılan deneyiminiz için varsayılanlar sağlamak üzere kullanılan, tercih edilen yazı tipi boyutu, tercih edilen yazı tipi ve dosya ayrıntıları Paylaş Bu sürücü geri bulut.Azure Cloud Shell takes your personal data seriously, the data captured and stored by the Azure Cloud Shell service are used to provide defaults for your experience such as your most recently used shell, preferred font size, preferred font type, and file share details that back cloud drive. Dışarı aktarma veya bu verileri silmek istemeniz durumunda, aşağıdaki yönergeleri kullanın.Should you wish to export or delete this data, use the following instructions.

Not

Bu makale, cihazdan veya hizmetten kişisel verileri silme adımlarını sağlar ve GDPR kapsamındaki yükümlülüklerinizi desteklemek için kullanılabilir.This article provides steps for how to delete personal data from the device or service and can be used to support your obligations under the GDPR. GDPR hakkında genel bilgiler arıyorsanız, Hizmet Güveni portalının GDPR bölümüne bakın.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Dışarı AktarmaExport

Şunları dışarı kabuğu, yazı tipi boyutunu ve yazı tipi aşağıdaki komutları çalıştırın Cloud Shell kaydeder, gibi kullanıcı ayarları tercih edilir.In order to export the user settings Cloud Shell saves for you such as preferred shell, font size, and font type run the following commands.

  1. Bash veya PowerShell içinde aşağıdaki komutları çalıştırın:Run the following commands in Bash or PowerShell:

Bash:Bash:

token="Bearer $(curl http://localhost:50342/oauth2/token --data "resource=https://management.azure.com/" -H Metadata:true -s | jq -r ".access_token")"
curl https://management.azure.com/providers/Microsoft.Portal/usersettings/cloudconsole?api-version=2017-12-01-preview -H Authorization:"$token" -s | jq

PowerShell:PowerShell:

$token= ((Invoke-WebRequest -Uri "$env:MSI_ENDPOINT`?resource=https://management.core.windows.net/" -Headers @{Metadata='true'}).content |  ConvertFrom-Json).access_token
((Invoke-WebRequest -Uri https://management.azure.com/providers/Microsoft.Portal/usersettings/cloudconsole?api-version=2017-12-01-preview -Headers @{Authorization = "Bearer $token"}).Content | ConvertFrom-Json).properties | Format-List

SilDelete

Şunları Sil Cloud Shell kaydeder, gibi kullanıcı ayarlarınızı kabuğu, yazı tipi boyutunu ve yazı tipi aşağıdaki komutları çalıştırın tercih edilir.In order to delete your user settings Cloud Shell saves for you such as preferred shell, font size, and font type run the following commands. Cloud Shell'i yeniden başlattığınızda, yerleşik bir dosya paylaşımı yeniden istenir.The next time you start Cloud Shell you will be asked to onboard a file share again.

Not

Kullanıcı ayarlarınızı silerseniz, gerçek Azure dosyaları paylaşım silinmez.If you delete your user settings, the actual Azure Files share will not be deleted. Bu eylemi tamamlamak için Azure dosyalarınıza gidin.Go to your Azure Files to complete that action.

  1. Bash veya PowerShell içinde aşağıdaki komutları çalıştırın:Run the following commands in Bash or PowerShell:

Bash:Bash:

token="Bearer $(curl http://localhost:50342/oauth2/token --data "resource=https://management.azure.com/" -H Metadata:true -s | jq -r ".access_token")"
curl -X DELETE https://management.azure.com/providers/Microsoft.Portal/usersettings/cloudconsole?api-version=2017-12-01-preview -H Authorization:"$token"

PowerShell:PowerShell:

$token= ((Invoke-WebRequest -Uri "$env:MSI_ENDPOINT`?resource=https://management.core.windows.net/" -Headers @{Metadata='true'}).content |  ConvertFrom-Json).access_token
Invoke-WebRequest -Method Delete -Uri https://management.azure.com/providers/Microsoft.Portal/usersettings/cloudconsole?api-version=2017-12-01-preview -Headers @{Authorization = "Bearer $token"}