New-AzStorageContext

Başvuru

Modül:: Az.Storage

Azure Depolama bağlamı oluşturur.

Sözdizimi

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   -BlobEndpoint <String>
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   -SasToken <String>
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]

New-AzStorageContext
   [-Local]
   [<CommonParameters>]

New-AzStorageContext
   [-Anonymous]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-UseConnectedAccount]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

Description

New-AzStorageContext cmdlet'i bir Azure Depolama bağlamı oluşturur. Depolama Bağlamının varsayılan Kimlik Doğrulaması, yalnızca Depolama hesabı adı girdiyse OAuth (Microsoft Entra Id) şeklindedir. depolama hizmeti kimlik doğrulamasının ayrıntılarına https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-servicesbakın.

Örnekler

Örnek 1: Depolama hesabı adı ve anahtarı belirterek bağlam oluşturma

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Bu komut, belirtilen anahtarı kullanan ContosoGeneral adlı hesap için bir bağlam oluşturur.

Örnek 2: bağlantı dizesi belirterek bağlam oluşturma

New-AzStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Bu komut ContosoGeneral hesabı için belirtilen bağlantı dizesi temel alan bir bağlam oluşturur.

Örnek 3: Anonim depolama hesabı için bağlam oluşturma

New-AzStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Bu komut, ContosoGeneral adlı hesap için anonim kullanım için bir bağlam oluşturur. komutu HTTP'yi bağlantı protokolü olarak belirtir.

Örnek 4: Yerel geliştirme depolama hesabını kullanarak bağlam oluşturma

New-AzStorageContext -Local

Bu komut, yerel geliştirme depolama hesabını kullanarak bir bağlam oluşturur. komutu Local parametresini belirtir.

Örnek 5: Yerel geliştirici depolama hesabı için kapsayıcıyı alma

New-AzStorageContext -Local | Get-AzStorageContainer

Bu komut, yerel geliştirme depolama hesabını kullanarak bir bağlam oluşturur ve ardından işlem hattı işlecini kullanarak yeni bağlamı Get-AzStorageContainer cmdlet'ine geçirir. komutu yerel geliştirici depolama hesabı için Azure Depolama kapsayıcısını alır.

Örnek 6: Birden çok kapsayıcı alma

$Context01 = New-AzStorageContext -Local 
$Context02 = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
($Context01, $Context02) | Get-AzStorageContainer

İlk komut, yerel geliştirme depolama hesabını kullanarak bir bağlam oluşturur ve ardından bu bağlamı $Context 01 değişkeninde depolar. İkinci komut, belirtilen anahtarı kullanan ContosoGeneral adlı hesap için bir bağlam oluşturur ve bu bağlamı $Context 02 değişkeninde depolar. Son komut, Get-AzStorageContainer kullanarak $Context 01 ve $Context 02'de depolanan bağlamlar için kapsayıcıları alır.

Örnek 7: Uç nokta ile bağlam oluşturma

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

Bu komut, belirtilen depolama uç noktasına sahip bir Azure Depolama bağlamı oluşturur. komutu, belirtilen anahtarı kullanan ContosoGeneral adlı hesabın bağlamını oluşturur.

Örnek 8: Belirtilen bir ortamla bağlam oluşturma

New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

Bu komut, belirtilen Azure ortamına sahip bir Azure depolama bağlamı oluşturur. komutu, belirtilen anahtarı kullanan ContosoGeneral adlı hesabın bağlamını oluşturur.

Örnek 9: SAS belirteci kullanarak bağlam oluşturma

$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"

İlk komut, ContosoMain adlı kapsayıcı için New-AzStorageContainerSASToken cmdlet'ini kullanarak bir SAS belirteci oluşturur ve ardından bu belirteci $SasToken değişkeninde depolar. Bu belirteç okuma, ekleme, güncelleştirme ve silme izinlerine yöneliktir. İkinci komut, contosogeneral adlı hesap için $SasToken depolanan SAS belirtecini kullanan bir bağlam oluşturur ve bu bağlamı $Context değişkeninde depolar. Son komut, $Context'de depolanan bağlamı kullanarak ContosoMain adlı kapsayıcıyla ilişkili tüm blobları listeler.

Örnek 10: OAuth Kimlik Doğrulamasını kullanarak bağlam oluşturma

Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Bu komut, OAuth (Microsoft Entra ID) Kimlik Doğrulamasını kullanarak bir bağlam oluşturur.

Örnek 11: Depolama hesabı adı, depolama hesabı anahtarı ve özel blob uç noktası belirterek bağlam oluşturma

New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Bu komut, hesabın anahtarı ve belirtilen blob uç noktası ile myaccountname adlı hesap için bir bağlam oluşturur.

Örnek 12: Belirtilen blob uç noktasına sahip anonim bir depolama hesabı için bağlam oluşturma

New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"

Bu komut, belirtilen blob enpoint ile myaccountname adlı hesap için anonim kullanım için bir bağlam oluşturur.

Örnek 13: Belirtilen uç noktalarla SAS belirteci kullanarak bağlam oluşturma

$SasToken = New-AzStorageContainerSASToken -Name "MyContainer" -Permission "rad"
New-AzStorageContext -SasToken $SasToken -BlobEndpoint "https://myaccountname.blob.core.windows.net/" -TableEndpoint "https://myaccountname.table.core.windows.net/" -FileEndpoint "https://myaccountname.file.core.windows.net/" -QueueEndpoint "https://myaccountname.queue.core.windows.net/"

İlk komut, MyContainer adlı kapsayıcı için New-AzStorageContainerSASToken cmdlet'ini kullanarak bir SAS belirteci oluşturur ve ardından bu belirteci $SasToken değişkeninde depolar. İkinci komut SAS belirtecini ve belirtilen blob uç noktasını, tablo uç noktasını, dosya uç noktasını ve kuyruk uç noktasını kullanan bir bağlam oluşturur.

Örnek 14: Belirtilen blob uç noktasıyla OAuth Kimlik Doğrulamasını kullanarak bağlam oluşturma

New-AzStorageContext -UseConnectedAccount -BlobEndpoint  "https://myaccountname.blob.core.windows.net/"

Bu komut, belirtilen blob uç noktasıyla OAuth kimlik doğrulamasını kullanarak bir bağlam oluşturur.

Örnek 15: Dosya hizmetinde OAuth Kimlik Doğrulaması kullanarak bağlam oluşturma

New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent

Bu komut, Dosya hizmetinde OAuth (Microsoft Entra Id) kimlik doğrulamasını kullanmak için bir bağlam oluşturur. Dosya hizmeti için OAuth (Microsoft Entra ID) Kimlik Doğrulamasını kullanmak için '-EnableFileBackupRequestIntent' parametresi gereklidir. Bu, söz konusu dosyalar/dizinler için ACL'ler olsa bile izin verilen veri eylemlerine bağlı olarak tüm dosya/dizin düzeyi izin denetimlerini atlar ve erişime izin verir.

Parametreler

-Anonymous

Bu cmdlet'in anonim oturum açma için bir Azure Depolama bağlamı oluşturduğunu gösterir.

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

-BlobEndpoint

Azure depolama blob hizmeti uç noktası

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

-ConnectionString

Azure Depolama bağlamı için bir bağlantı dizesi belirtir.

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

-EnableFileBackupRequestIntent

Dosyalar için OAuth (Microsoft Entra Id) Kimlik Doğrulaması ile kullanmak için gerekli parametre. Bu, söz konusu dosyalar/dizinler için ACL'ler olsa bile izin verilen veri eylemlerine bağlı olarak tüm dosya/dizin düzeyi izin denetimlerini atlar ve erişime izin verir.

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

-Endpoint

Azure Depolama bağlamı için uç noktayı belirtir.

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

-Environment

Azure ortamını belirtir. Bu parametre için kabul edilebilir değerler şunlardır: AzureCloud ve AzureChinaCloud. Daha fazla bilgi için yazın Get-Help Get-AzEnvironment.

Tür:	String
Diğer adlar:	Name, EnvironmentName
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-FileEndpoint

Azure depolama dosya hizmeti uç noktası

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

-Local

Bu cmdlet'in yerel geliştirme depolama hesabını kullanarak bir bağlam oluşturduğunu gösterir.

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

-Protocol

Aktarım Protokolü (https/http).

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

-QueueEndpoint

Azure depolama kuyruğu hizmet uç noktası

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

-SasToken

Bağlam için bir Paylaşılan Erişim İmzası (SAS) belirteci belirtir.

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

-StorageAccountKey

Azure Depolama hesabı anahtarını belirtir. Bu cmdlet, bu parametrenin belirttiği anahtar için bir bağlam oluşturur.

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

-StorageAccountName

Bir Azure Depolama hesabı adı belirtir. Bu cmdlet, bu parametrenin belirttiği hesap için bir bağlam oluşturur.

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

-TableEndpoint

Azure depolama tablosu hizmet uç noktası

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

-UseConnectedAccount

Bu cmdlet'in OAuth (Microsoft Entra ID) Kimlik Doğrulaması ile bir Azure Depolama bağlamı oluşturduğunu gösterir. Cmdlet, diğer kimlik doğrulaması belirtilmediğinde varsayılan olarak OAuth Kimlik Doğrulaması kullanır.

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

Girişler

String

Çıkışlar

AzureStorageContext

Aracılığıyla paylaş

New-AzStorageContext

Sözdizimi

Description

Örnekler

Örnek 1: Depolama hesabı adı ve anahtarı belirterek bağlam oluşturma

Örnek 2: bağlantı dizesi belirterek bağlam oluşturma

Örnek 3: Anonim depolama hesabı için bağlam oluşturma

Örnek 4: Yerel geliştirme depolama hesabını kullanarak bağlam oluşturma

Örnek 5: Yerel geliştirici depolama hesabı için kapsayıcıyı alma

Örnek 6: Birden çok kapsayıcı alma

Örnek 7: Uç nokta ile bağlam oluşturma

Örnek 8: Belirtilen bir ortamla bağlam oluşturma

Örnek 9: SAS belirteci kullanarak bağlam oluşturma

Örnek 10: OAuth Kimlik Doğrulamasını kullanarak bağlam oluşturma

Örnek 11: Depolama hesabı adı, depolama hesabı anahtarı ve özel blob uç noktası belirterek bağlam oluşturma

Örnek 12: Belirtilen blob uç noktasına sahip anonim bir depolama hesabı için bağlam oluşturma

Örnek 13: Belirtilen uç noktalarla SAS belirteci kullanarak bağlam oluşturma

Örnek 14: Belirtilen blob uç noktasıyla OAuth Kimlik Doğrulamasını kullanarak bağlam oluşturma

Örnek 15: Dosya hizmetinde OAuth Kimlik Doğrulaması kullanarak bağlam oluşturma

Parametreler

-Anonymous

-BlobEndpoint

-ConnectionString

-EnableFileBackupRequestIntent

-Endpoint

-Environment

-FileEndpoint

-Local

-Protocol

-QueueEndpoint

-SasToken

-StorageAccountKey

-StorageAccountName

-TableEndpoint

-UseConnectedAccount

Girişler

Çıkışlar

Ek kaynaklar

Aracılığıyla paylaş

New-AzStorageContext

Sözdizimi

Description

Örnekler

Örnek 1: Depolama hesabı adı ve anahtarı belirterek bağlam oluşturma

Örnek 2: bağlantı dizesi belirterek bağlam oluşturma

Örnek 3: Anonim depolama hesabı için bağlam oluşturma

Örnek 4: Yerel geliştirme depolama hesabını kullanarak bağlam oluşturma

Örnek 5: Yerel geliştirici depolama hesabı için kapsayıcıyı alma

Örnek 6: Birden çok kapsayıcı alma

Örnek 7: Uç nokta ile bağlam oluşturma

Örnek 8: Belirtilen bir ortamla bağlam oluşturma

Örnek 9: SAS belirteci kullanarak bağlam oluşturma

Örnek 10: OAuth Kimlik Doğrulamasını kullanarak bağlam oluşturma

Örnek 11: Depolama hesabı adı, depolama hesabı anahtarı ve özel blob uç noktası belirterek bağlam oluşturma

Örnek 12: Belirtilen blob uç noktasına sahip anonim bir depolama hesabı için bağlam oluşturma

Örnek 13: Belirtilen uç noktalarla SAS belirteci kullanarak bağlam oluşturma

Örnek 14: Belirtilen blob uç noktasıyla OAuth Kimlik Doğrulamasını kullanarak bağlam oluşturma

Örnek 15: Dosya hizmetinde OAuth Kimlik Doğrulaması kullanarak bağlam oluşturma

Parametreler

-Anonymous

-BlobEndpoint

-ConnectionString

-EnableFileBackupRequestIntent

-Endpoint

-Environment

-FileEndpoint

-Local

-Protocol

-QueueEndpoint

-SasToken

-StorageAccountKey

-StorageAccountName

-TableEndpoint

-UseConnectedAccount

Girişler

Çıkışlar

İlişkili Bağlantılar

Ek kaynaklar