New-AzStorageContext

Başvuru

Modül:: Az.Storage

Azure Depolama bağlamı oluşturur.

Syntax

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-Az Depolama Context cmdlet'i bir Azure Depolama bağlamı oluşturur. Depolama Bağlamının varsayılan Kimlik Doğrulaması, yalnızca Depolama hesap adı girdiyse OAuth 'dır (Microsoft Entra Id). Depolama Hizmeti kimlik doğrulamasının ayrıntılarına bakınhttps://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Ö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-Az Depolama Container 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-Az Depolama Container 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-Az Depolama ContainerSASToken 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-Az Depolama ContainerSASToken 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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BlobEndpoint

Azure depolama blob hizmeti uç noktası

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionString

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Endpoint

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Aliases:	Name, EnvironmentName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-FileEndpoint

Azure depolama dosya hizmeti uç noktası

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Local

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Protocol

Aktarım Protokolü (https/http).

Type:	String
Accepted values:	Http, Https
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QueueEndpoint

Azure depolama kuyruğu hizmet uç noktası

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SasToken

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountKey

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountName

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TableEndpoint

Azure depolama tablosu hizmet uç noktası

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

String

Çıkışlar

AzureStorageContext