Aracılığıyla paylaş

Azure CLI ile Azure dosya paylaşımlarını geri yükleme

  • Makale

Azure CLI, Azure kaynaklarını yönetmek için bir komut satırı deneyimi sağlar. Azure kaynaklarını kullanmak için özel otomasyon oluşturmak için harika bir araçtır. Bu makalede, Azure CLI kullanılarak Azure Backup tarafından oluşturulan bir geri yükleme noktasından dosya paylaşımının tamamının veya belirli dosyaların nasıl geri yükleneceği açıklanmaktadır. Bu adımları Azure PowerShell veya Azure portalı ile de gerçekleştirebilirsiniz.

Bu makalenin sonunda Azure CLI ile aşağıdaki işlemleri gerçekleştirmeyi öğreneceksiniz:

  • Yedeklenen Azure dosya paylaşımının geri yükleme noktalarını görüntüleyin.
  • Tam azure dosya paylaşımını geri yükleyin.
  • Tek tek dosyaları veya klasörleri geri yükleyin.

Not

Azure Backup artık Azure CLI kullanarak birden çok dosya veya klasörün özgün veya alternatif bir konuma geri yüklenmesini destekliyor. Daha fazla bilgi edinmek için bu belgenin Birden çok dosya veya klasörü özgün veya alternatif konuma geri yükleme bölümüne bakın.

Önkoşullar

Bu makalede, Azure Backup tarafından yedeklenmiş bir Azure dosya paylaşımınız olduğu varsayılır. Dosya paylaşımınız yoksa, dosya paylaşımınız için yedeklemeyi yapılandırmak için bkz . Azure dosya paylaşımlarını CLI ile yedekleme. Bu makale için aşağıdaki kaynakları kullanırsınız:

Dosya paylaşımı Storage account Bölge Ayrıntılar
azurefiles afsaccount EastUS Azure Backup kullanılarak yedeklenen özgün kaynak
azurefiles1 afaccount1 EastUS Alternatif konum kurtarma için kullanılan hedef kaynak

Bu makalede açıklanan farklı geri yükleme türlerini denemek için dosya paylaşımlarınız için benzer bir yapı kullanabilirsiniz.

Ortamınızı Azure CLI’ye hazırlama

  • Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

  • Bu öğretici, Azure CLI'nın 2.0.18 veya sonraki bir sürümünü gerektirir. Azure Cloud Shell kullanılıyorsa en son sürüm zaten yüklüdür.

Azure dosya paylaşımı için kurtarma noktalarını getirme

Yedeklenen dosya paylaşımının tüm kurtarma noktalarını listelemek için az backup recoverypoint list cmdlet'ini kullanın.

Aşağıdaki örnek, afsaccount depolama hesabındaki azurefiles dosya paylaşımı için kurtarma noktalarının listesini getirir.

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table

Aşağıdaki iki ek parametreyi sağlayarak kapsayıcının ve öğenin kolay adını kullanarak önceki cmdlet'i de çalıştırabilirsiniz:

  • --backup-management-type: azurestorage
  • --workload-type: azurefileshare
az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table

Sonuç kümesi, her geri yükleme noktası için zaman ve tutarlılık ayrıntılarını içeren kurtarma noktalarının listesidir.

Name                Time                        Consistency
------------------  -------------------------   --------------------
932887541532871865  2020-01-05T07:08:23+00:00   FileSystemConsistent
932885927361238054  2020-01-05T07:08:10+00:00   FileSystemConsistent
932879614553967772  2020-01-04T21:33:04+00:00   FileSystemConsistent

Çıktıdaki Name özniteliği, kurtarma işlemlerinde --rp-name parametresi için değer olarak kullanılabilecek kurtarma noktası adına karşılık gelir.

Azure CLI kullanarak tam paylaşım kurtarma

Dosya paylaşımının tamamını özgün konuma veya alternatif bir konuma geri yüklemek için bu geri yükleme seçeneğini kullanabilirsiniz.

Geri yükleme işlemlerini gerçekleştirmek için aşağıdaki parametreleri tanımlayın:

  • --container-name: Yedeklenen özgün dosya paylaşımını barındıran depolama hesabının adı. Kapsayıcınızın adını veya kolay adını almak için az backup container list komutunu kullanın.
  • --item-name: Geri yükleme işlemi için kullanmak istediğiniz yedeklenen özgün dosya paylaşımının adı. Yedeklenen öğenizin adını veya kolay adını almak için az backup item list komutunu kullanın.

Tam paylaşımı özgün konuma geri yükleme

Özgün bir konuma geri yüklerken, hedefle ilgili parametreleri belirtmeniz gerekmez. Yalnızca Çakışmayı Çöz sağlanmalıdır.

Aşağıdaki örnek, azurefiles dosya paylaşımını özgün konuma geri yüklemek için geri yükleme modu özgün konumuna ayarlanmış az backup restore restore-azurefileshare cmdlet'ini kullanır. Kurtarma noktası 932883129628959823 kullanırsınız. Bu, Azure dosya paylaşımı için kurtarma noktalarını getirme bölümünde elde edilir:

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865   --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb  azurefiles

Çıktıdaki Name özniteliği, geri yükleme işleminiz için yedekleme hizmeti tarafından oluşturulan işin adına karşılık gelir. İşin durumunu izlemek için az backup job show cmdlet'ini kullanın.

Tam paylaşımı alternatif bir konuma geri yükleme

Bir dosya paylaşımını alternatif bir konuma geri yüklemek ve özgün dosya paylaşımını olduğu gibi tutmak için bu seçeneği kullanabilirsiniz. Alternatif konum kurtarma için aşağıdaki parametreleri belirtin:

  • --target-storage-account: Yedeklenen içeriğin geri yüklendiği depolama hesabı. Hedef depolama hesabının kasayla aynı konumda olması gerekir.
  • --target-file-share: Yedeklenen içeriğin geri yüklendiği hedef depolama hesabı içindeki dosya paylaşımı.
  • --target-folder: Verilerin geri yüklendiği dosya paylaşımının altındaki klasör. Yedeklenen içerik bir kök klasöre geri yüklenecekse hedef klasör değerlerini boş bir dize olarak verin.
  • --resolve-conflict: Geri yüklenen verilerle çakışma varsa yönerge. Üzerine Yazmayı veya Atla'yı kabul eder.

Aşağıdaki örnekte, afsaccount depolama hesabındaki azurefiles dosya paylaşımını afaccount1 depolama hesabındaki azurefiles1" dosya paylaşımına geri yüklemek için geri yükleme moduyla az backup restore restore-azurefileshare kullanılır.

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a  azurefiles

Çıktıdaki Name özniteliği, geri yükleme işleminiz için yedekleme hizmeti tarafından oluşturulan işin adına karşılık gelir. İşin durumunu izlemek için az backup job show cmdlet'ini kullanın.

Öğe düzeyinde kurtarma

Tek tek dosyaları veya klasörleri özgün veya alternatif bir konuma geri yüklemek için bu geri yükleme seçeneğini kullanabilirsiniz.

Geri yükleme işlemlerini gerçekleştirmek için aşağıdaki parametreleri tanımlayın:

  • --container-name: Yedeklenen özgün dosya paylaşımını barındıran depolama hesabının adı. Kapsayıcınızın adını veya kolay adını almak için az backup container list komutunu kullanın.
  • --item-name: Geri yükleme işlemi için kullanmak istediğiniz yedeklenen özgün dosya paylaşımının adı. Yedeklenen öğenizin adını veya kolay adını almak için az backup item list komutunu kullanın.

Kurtarmak istediğiniz öğeler için aşağıdaki parametreleri belirtin:

  • SourceFilePath: Dosya paylaşımı içinde dize olarak geri yüklenecek dosyanın mutlak yolu. Bu yol, az storage file download veya az storage file show CLI komutlarında kullanılan yolla aynıdır.
  • SourceFileType: Bir dizinin mi yoksa dosyanın mı seçileceğini seçin. Dizin veya Dosya kabul eder.
  • ResolveConflict: Geri yüklenen verilerle çakışma olması durumunda yönerge. Üzerine Yazmayı veya Atla'yı kabul eder.

Tek tek dosyaları veya klasörleri özgün konuma geri yükleme

Belirli dosyaları veya klasörleri özgün konumlarına geri yüklemek için geri yükleme modu özgün konumuna ayarlanmış az backup restore restore-azurefiles cmdlet'ini kullanın.

Aşağıdaki örnek, RestoreTest.txt dosyasını özgün konumuna geri yükler: azurefiles dosya paylaşımı.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite  --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

Çıktıdaki Name özniteliği, geri yükleme işleminiz için yedekleme hizmeti tarafından oluşturulan işin adına karşılık gelir. İşin durumunu izlemek için az backup job show cmdlet'ini kullanın.

Tek tek dosyaları veya klasörleri alternatif bir konuma geri yükleme

Belirli dosyaları veya klasörleri alternatif bir konuma geri yüklemek için az backup restore restore-azurefiles cmdlet'ini kullanın ve geri yükleme modu alternatelocation olarak ayarlanmış ve hedefle ilgili aşağıdaki parametreleri belirtin:

  • --target-storage-account: Yedeklenen içeriğin geri yüklendiği depolama hesabı. Hedef depolama hesabının kasayla aynı konumda olması gerekir.
  • --target-file-share: Yedeklenen içeriğin geri yüklendiği hedef depolama hesabı içindeki dosya paylaşımı.
  • --target-folder: Verilerin geri yüklendiği dosya paylaşımının altındaki klasör. Yedeklenen içerik bir kök klasöre geri yüklenecekse, hedef klasörün değerini boş bir dize olarak verin.

Aşağıdaki örnek, başlangıçta azurefiles dosya paylaşımında bulunan RestoreTest.txt dosyasını alternatif bir konuma geri yükler: afaccount1 depolama hesabında barındırılan azurefiles1 dosya paylaşımındaki restoredata klasörü.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

Çıktıdaki Name özniteliği, geri yükleme işleminiz için yedekleme hizmeti tarafından oluşturulan işin adına karşılık gelir. İşin durumunu izlemek için az backup job show cmdlet'ini kullanın.

Birden çok dosya veya klasörü özgün veya alternatif konuma geri yükleme

Birden çok öğe için geri yükleme gerçekleştirmek için, source-file-path parametresinin değerini geri yüklemek istediğiniz tüm dosya veya klasörlerin boşlukla ayrılmış yolları olarak geçirin.

Aşağıdaki örnek, Restore.txt ve AFS test Report.docx dosyalarını özgün konumlarına geri yükler.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite  --out table

Çıktı aşağıdakine benzerdir.

Name                                          ResourceGroup
------------------------------------          ---------------
649b0c14-4a94-4945-995a-19e2aace0305          azurefiles

Çıktıdaki Name özniteliği, geri yükleme işleminiz için yedekleme hizmeti tarafından oluşturulan işin adına karşılık gelir. İşin durumunu izlemek için az backup job show cmdlet'ini kullanın.

Birden çok öğeyi alternatif bir konuma geri yüklemek istiyorsanız, Tek tek dosyaları veya klasörleri alternatif bir konuma geri yükleme bölümünde açıklandığı gibi hedefle ilgili parametreleri belirterek yukarıdaki komutu kullanın.

Sonraki adımlar

Azure CLI ile Azure dosya paylaşımı yedeklemelerini yönetmeyi öğrenin.