az storage fs directory

Azure Data Lake Storage 2. Nesil hesabındaki dizinleri yönetin.

Komutlar

Name Description Tür Durum
az storage fs directory create

ADLS 2. Nesil dosya sisteminde bir dizin oluşturun.

Core GA
az storage fs directory delete

ADLS 2. Nesil dosya sisteminde bir dizini silin.

Core GA
az storage fs directory download

ADLS 2. Nesil dosya sistemindeki dizinden yerel dosya yoluna dosya indirin.

Core Preview
az storage fs directory exists

ADLS 2. Nesil dosya sisteminde dizin olup olmadığını denetleyin.

Core GA
az storage fs directory generate-sas

ADLS 2. Nesil hesabında dizin için bir SAS belirteci oluşturun.

Core GA
az storage fs directory list

ADLS 2. Nesil dosya sistemindeki dizinleri listeleyin.

Core GA
az storage fs directory metadata

Dosya sistemindeki dizinin meta verilerini yönetin.

Core GA
az storage fs directory metadata show

Belirtilen dizin için kullanıcı tanımlı tüm meta verileri döndürür.

Core GA
az storage fs directory metadata update

Belirtilen dosya sistemi için bir veya daha fazla kullanıcı tanımlı ad-değer çifti ayarlar.

Core GA
az storage fs directory move

ADLS 2. Nesil dosya sisteminde bir dizini taşıma.

Core GA
az storage fs directory show

ADLS 2. Nesil dosya sisteminde bir dizinin özelliklerini gösterir.

Core GA
az storage fs directory upload

ADLS 2. Nesil dosya sistemindeki bir dizine dosya veya alt dizin yükleyin.

Core Preview

az storage fs directory create

ADLS 2. Nesil dosya sisteminde bir dizin oluşturun.

az storage fs directory create --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--acquire-policy-token]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--change-reference]
                               [--connection-string]
                               [--metadata]
                               [--permissions]
                               [--sas-token]
                               [--timeout]
                               [--umask]

Örnekler

ADLS 2. Nesil dosya sisteminde bir dizin oluşturun.

az storage fs directory create -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

bağlantı dizesi aracılığıyla ADLS 2. Nesil dosya sisteminde bir dizin oluşturun.

az storage fs directory create -n dir -f myfilesystem --connection-string myconnectionstring

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

--name -n

Dizinin adı.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--metadata

Boşlukla ayrılmış anahtar=değer çiftlerindeki meta veriler. Bu, var olan tüm meta verilerin üzerine yazar.

--permissions

Dosya sahibi, dosya sahibi grubu ve diğerleri için POSIX erişim izinleri. Her sınıfa okuma (4), yazma (2) veya yürütme (1) izni verilebilir. Hem sembolik (rwxrw-rw-) hem de 4 basamaklı sekizli gösterimi (ör. 0766) desteklenir. Yapışkan bit de desteklenir ve sembolik gösterimde, diğerleri kategorisi için yürütme bitinin sırasıyla ayarlanıp ayarlanmadığına (örneğin rwxrw-rw- yapışkan bit ile rwxrw-rwT olarak gösterilir) son karakter yerinde t veya T harfiyle gösterilir. Yapışkan bitli rwxrw-rwx, rwxrw-rwt olarak gösterilir), t veya T olmaması yapışkan bitin ayarlanmadığını gösterir. 4 basamaklı sekizli gösteriminde, 1. basamakla temsil edilir (örneğin, 1766, yapışkan bitli rwxrw-rw-'yi, 0766 ise yapışkan bit olmadan rwxrw-rw'yi temsil eder). Daha fazla bilgi için bkz. https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#levels-of-permission.

--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--timeout

Saniyeler içinde istek zaman aşımı. Hizmete yapılan her çağrı için geçerlidir.

--umask

Bir dosya veya dizin oluştururken ve üst klasör varsayılan ACL'ye sahip olmadığında, umask oluşturulacak dosya veya dizinin izinlerini kısıtlar. Sonuçta elde edilen izin p & ^u tarafından verilir; burada p izindir ve siz umask'sınız. Daha fazla bilgi için bkz. https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-access-control#umask.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory delete

ADLS 2. Nesil dosya sisteminde bir dizini silin.

az storage fs directory delete --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--acquire-policy-token]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--change-reference]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]
                               [--yes]

Örnekler

ADLS 2. Nesil dosya sisteminde bir dizini silin.

az storage fs directory delete -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

ADLS 2. Nesil dosya sisteminde bir dizini silin. (autogenerated)

az storage fs directory delete --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir --yes

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

--name -n

Dizinin adı.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--timeout

Saniyeler içinde istek zaman aşımı. Hizmete yapılan her çağrı için geçerlidir.

--yes -y

Onay istemde bulunmayın.

Özellik Değer
Default value: False
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory download

Önizleme

Bu komut önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

ADLS 2. Nesil dosya sistemindeki dizinden yerel dosya yoluna dosya indirin.

az storage fs directory download --destination-path
                                 --file-system
                                 [--account-key]
                                 [--account-name]
                                 [--acquire-policy-token]
                                 [--auth-mode {key, login}]
                                 [--change-reference]
                                 [--connection-string]
                                 [--recursive]
                                 [--sas-token]
                                 [--service-endpoint]
                                 [--source-path]

Örnekler

ADLS 2. Nesil dosya sistemindeki bir dizinde tek bir dosya indirin.

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s "path/to/file" -d "<local-path>"

AdLS 2. Nesil dosya sisteminin tamamını indirin.

az storage fs directory download -f myfilesystem --account-name mystorageaccount  -d "<local-path>" --recursive

ADLS 2. Nesil dosya sisteminde dizinin tamamını indirin.

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s SourceDirectoryPath -d "<local-path>" --recursive

ADLS 2. Nesil dosya sisteminde bir alt dizinin tamamını indirin.

az storage fs directory download -f myfilesystem --account-name mystorageaccount -s "path/to/subdirectory" -d "<local-path>" --recursive

Gerekli Parametreler

--destination-path -d

İndirilecek hedef yerel dizin yolu.

--file-system -f

İndirme kaynak dosya sistemi.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--recursive -r

Dosyaları özyinelemeli olarak indirin. Etkinleştirilirse, alt dizinlerdeki dosyalar da dahil olmak üzere tüm dosyalar indirilir.

--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--service-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--source-path -s

İndirme kaynak dizini yolu. Dosya sisteminin mutlak yolu olmalıdır.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory exists

ADLS 2. Nesil dosya sisteminde dizin olup olmadığını denetleyin.

az storage fs directory exists --file-system
                               --name
                               [--account-key]
                               [--account-name]
                               [--acquire-policy-token]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--change-reference]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

Örnekler

ADLS 2. Nesil dosya sisteminde dizin olup olmadığını denetleyin.

az storage fs directory exists -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

ADLS 2. Nesil dosya sisteminde dizin olup olmadığını denetleyin. (autogenerated)

az storage fs directory exists --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

--name -n

Dizinin adı.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--timeout

Saniyeler içinde istek zaman aşımı. Hizmete yapılan her çağrı için geçerlidir.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory generate-sas

ADLS 2. Nesil hesabında dizin için bir SAS belirteci oluşturun.

az storage fs directory generate-sas --file-system
                                     --name
                                     [--account-key]
                                     [--account-name]
                                     [--acquire-policy-token]
                                     [--as-user]
                                     [--auth-mode {key, login}]
                                     [--blob-endpoint]
                                     [--cache-control]
                                     [--change-reference]
                                     [--connection-string]
                                     [--content-disposition]
                                     [--content-encoding]
                                     [--content-language]
                                     [--content-type]
                                     [--encryption-scope]
                                     [--expiry]
                                     [--full-uri]
                                     [--https-only]
                                     [--ip]
                                     [--permissions]
                                     [--policy-name]
                                     [--start]
                                     [--user-delegation-oid]
                                     [--user-delegation-tid]

Örnekler

Dizin için bir sas belirteci oluşturun ve dosyaları karşıya yüklemek için bu belirteci kullanın.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage fs directory generate-sas --name dir --file-system myfilesystem --https-only --permissions dlrw --expiry $end -o tsv

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

--name -n

Dizinin adı.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--as-user

Bu komutun kullanıcı temsilci anahtarıyla imzalanmış SAS'yi döndürdüğünü gösterir. Bu bağımsız değişken belirtilirse süre sonu parametresi ve '--auth-mode login' gereklidir.

Özellik Değer
Default value: False
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--cache-control

Bu paylaşılan erişim imzasını kullanarak kaynağa erişildiğinde Cache-Control için yanıt üst bilgisi değeri.

--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--content-disposition

Kaynağa erişildiğinde content-Disposition için yanıt üst bilgisi değeribu paylaşılan erişim imzasını kullanır.

--content-encoding

Kaynağa erişildiğinde content-encoding için yanıt üst bilgisi değeribu paylaşılan erişim imzasını kullanır.

--content-language

Kaynağa erişildiğinde content-Language için yanıt üst bilgisi değeribu paylaşılan erişim imzasını kullanır.

--content-type

Kaynağa erişildiğinde content-Type için yanıt üst bilgisi değeribu paylaşılan erişim imzasını kullanır.

--encryption-scope

Yapılan bir isteğin şifreleme kapsamını belirterek tüm yazma işlemlerinin hizmetin şifrelenmesini sağlayın.

--expiry

SAS'nin geçersiz olduğu UTC tarih saat değerini (Y-m-d'T'H:M'Z') belirtir. Bu değeri belirten --policy-name ile bir depolanmış erişim ilkesine başvurulsa kullanmayın.

--full-uri

Bu komutun tam blob URI'sini ve paylaşılan erişim imzası belirtecini döndürdüğünü belirtin.

Özellik Değer
Default value: False
--https-only

Yalnızca HTTPS protokolüyle yapılan isteklere izin verir. Atlanırsa, hem HTTP hem de HTTPS protokolünden gelen isteklere izin verilir.

--ip

İsteklerin kabul edildiği IP adresini veya IP adresi aralığını belirtir. Yalnızca IPv4 stil adreslerini destekler.

--permissions

SAS'nin izinleri. İzin verilen değerler: (a)dd (c)reate (d)elete (e)xecute (l)ist (m)ove (o)wnership (p)ermissions (r)ead (w)rite. Bu değeri belirten --id ile bir depolanmış erişim ilkesine başvurulsa kullanmayın. Birleştirilebilir.

--policy-name

Depolanan erişim ilkesinin adı.

--start

SAS'nin geçerli olduğu UTC tarih saat değerini (Y-m-d'T'H:M'Z') belirtir. Bu değeri belirten --policy-name ile bir depolanmış erişim ilkesine başvurulsa kullanmayın. Varsayılan olarak isteğin zamanına göre yapılır.

--user-delegation-oid
Önizleme

Sonuçta elde edilen SAS URL'sini kullanma yetkisi olan kullanıcının Entra ID belirtir. Sonuçta elde edilen SAS URL'si, bu değerde belirtilen kullanıcıya verilmiş bir Entra ID belirteci ile birlikte kullanılmalıdır.

--user-delegation-tid
Önizleme

Azure AD'de delege edilmiş kullanıcı tenant id. Bu parametre yalnızca OAuth kullanılırken belirtilebilir.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory list

ADLS 2. Nesil dosya sistemindeki dizinleri listeleyin.

az storage fs directory list --file-system
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--num-results]
                             [--path]
                             [--recursive {false, true}]
                             [--sas-token]
                             [--timeout]

Örnekler

ADLS 2. Nesil dosya sistemindeki dizinleri listeleyin.

az storage fs directory list -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

ADLS 2. Nesil dosya sistemi için dizinleri "dir/" olarak listeleyin.

az storage fs directory list --path dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--num-results

Döndürülecek en fazla sonuç sayısını belirtin.

--path

Sonuçları yalnızca belirtilen yolun altındaki yolları döndürecek şekilde filtreleyin.

--recursive

True olarak ayarlandığında alt dizinleri özyinelemeli olarak araştır.

Özellik Değer
Default value: True
Kabul edilen değerler: false, true
--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--timeout

Saniyeler içinde istek zaman aşımı. Hizmete yapılan her çağrı için geçerlidir.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory move

ADLS 2. Nesil dosya sisteminde bir dizini taşıma.

az storage fs directory move --file-system
                             --name
                             --new-directory
                             [--account-key]
                             [--account-name]
                             [--acquire-policy-token]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--change-reference]
                             [--connection-string]
                             [--sas-token]
                             [--timeout]

Örnekler

AdLS 2. Nesil dosya sisteminde bir dizini taşıyın.

az storage fs directory move --new-directory newfs/dir -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

ADLS 2. Nesil dosya sisteminde bir dizini taşıma. (autogenerated)

az storage fs directory move --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir --new-directory newfs/dir

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

--name -n

Dizinin adı.

--new-directory -d

Kullanıcıların taşımak istediği yeni dizin adı. Değer şu biçime sahip olmalıdır: "{filesystem}/{directory}/{subdirectory}".

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--timeout

Saniyeler içinde istek zaman aşımı. Hizmete yapılan her çağrı için geçerlidir.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory show

ADLS 2. Nesil dosya sisteminde bir dizinin özelliklerini gösterir.

az storage fs directory show --file-system
                             --name
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--sas-token]
                             [--timeout]

Örnekler

ADLS 2. Nesil dosya sisteminde bir dizinin özelliklerini gösterir.

az storage fs directory show -n dir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

ADLS 2. Nesil dosya sisteminde bir alt dizinin özelliklerini gösterir.

az storage fs directory show -n dir/subdir -f myfilesystem --account-name myadlsaccount --account-key 0000-0000

ADLS 2. Nesil dosya sisteminde bir dizinin özelliklerini gösterir. (autogenerated)

az storage fs directory show --account-name myadlsaccount --auth-mode login --file-system myfilesystem --name dir

Gerekli Parametreler

--file-system -f

Dosya sistemi adı (kapsayıcı adı gibi).

--name -n

Dizinin adı.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--blob-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--timeout

Saniyeler içinde istek zaman aşımı. Hizmete yapılan her çağrı için geçerlidir.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False

az storage fs directory upload

Önizleme

Bu komut önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

ADLS 2. Nesil dosya sistemindeki bir dizine dosya veya alt dizin yükleyin.

az storage fs directory upload --file-system
                               --source
                               [--account-key]
                               [--account-name]
                               [--acquire-policy-token]
                               [--auth-mode {key, login}]
                               [--change-reference]
                               [--connection-string]
                               [--destination-path]
                               [--recursive]
                               [--sas-token]
                               [--service-endpoint]

Örnekler

Depolama blob dizinine tek bir dosya yükleyin.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/file" -d directory

ADLS 2. Nesil dosya sisteminde kök dizine yerel bir dizin yükleyin.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/directory" --recursive

ADLS 2. Nesil dosya sistemindeki bir dizine yerel dizin yükleyin.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/directory" -d directory --recursive

Yerel dizindeki bir dosya kümesini ADLS 2. Nesil dosya sistemindeki bir dizine yükleyin.

az storage fs directory upload -f myfilesystem --account-name mystorageaccount -s "path/to/file*" -d directory --recursive

Gerekli Parametreler

--file-system -f

Karşıya yükleme hedef dosya sistemi.

--source -s

Karşıya yüklenecek kaynak dosya yolu.

İsteğe Bağlı Parametreler

Aşağıdaki parametreler isteğe bağlıdır, ancak bağlama bağlı olarak komutun başarıyla yürütülmesi için bir veya daha fazla parametre gerekli olabilir.

--account-key

Depolama hesabı anahtarı. Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_KEY.

Özellik Değer
Parametre grubu: Storage Account Arguments
--account-name

Depolama hesabı adı. İlgili ortam değişkeni: AZURE_STORAGE_ACCOUNT. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. Hiçbiri yoksa, komut kimliği doğrulanmış Azure hesabını kullanarak depolama hesabı anahtarını sorgulamaya çalışır. Çok sayıda depolama komutu yürütülürse API kotası isabet alabilir.

Özellik Değer
Parametre grubu: Storage Account Arguments
--acquire-policy-token

Bu kaynak işlemi için otomatik olarak bir Azure İlkesi belirteci alma.

Özellik Değer
Parametre grubu: Global Policy Arguments
--auth-mode

Komutun çalıştırıldığı mod. "oturum açma" modu, kimlik doğrulaması için oturum açma kimlik bilgilerinizi doğrudan kullanır. Eski "anahtar" modu, hesap için kimlik doğrulama parametresi sağlanmayan bir hesap anahtarını sorgulamaya çalışır. Ortam değişkeni: AZURE_STORAGE_AUTH_MODE.

Özellik Değer
Kabul edilen değerler: key, login
--change-reference

Bu kaynak işlemi için ilgili değişiklik başvuru kimliği.

Özellik Değer
Parametre grubu: Global Policy Arguments
--connection-string

Depolama hesabı bağlantı dizesi. Ortam değişkeni: AZURE_STORAGE_CONNECTION_STRING.

Özellik Değer
Parametre grubu: Storage Account Arguments
--destination-path -d

Karşıya yükleme hedef dizin yolu. Dosya sisteminin mutlak yolu olmalıdır. Belirtilen hedef yol yoksa, yeni bir dizin yolu oluşturulur.

--recursive -r

Dosyaları özyinelemeli olarak karşıya yükleyin. Etkinleştirilirse, alt dizinlerdeki dosyalar da dahil olmak üzere tüm dosyalar karşıya yüklenir.

--sas-token

Paylaşılan Erişim İmzası (SAS). Depolama hesabı adı veya hizmet uç noktası ile birlikte kullanılmalıdır. Ortam değişkeni: AZURE_STORAGE_SAS_TOKEN.

Özellik Değer
Parametre grubu: Storage Account Arguments
--service-endpoint

Depolama veri hizmeti uç noktası. Depolama hesabı anahtarı veya SAS belirteci ile birlikte kullanılmalıdır. ile az storage account showher hizmet birincil uç noktasını bulabilirsiniz. Ortam değişkeni: AZURE_STORAGE_SERVICE_ENDPOINT.

Özellik Değer
Parametre grubu: Storage Account Arguments
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

Özellik Değer
Default value: False
--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

Özellik Değer
Default value: False
--output -o

Çıkış biçimi.

Özellik Değer
Default value: json
Kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz. http://jmespath.org/.

--subscription

Aboneliğin adı veya kimliği. az account set -s NAME_OR_IDkullanarak varsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

Özellik Değer
Default value: False