다음을 통해 공유


New-AzStorageContext

Azure Storage 컨텍스트를 만듭니다.

구문

OAuthAccount (기본값)

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

AccountNameAndKey

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

AccountNameAndKeyEnvironment

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

AnonymousAccount

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

AnonymousAccountEnvironment

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

SasToken

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

SasTokenWithAzureEnvironment

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

OAuthAccountEnvironment

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

AccountNameAndKeyServiceEndpoint

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

OAuthAccountServiceEndpoint

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

SasTokenServiceEndpoint

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

ConnectionString

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

LocalDevelopment

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

AnonymousAccountServiceEndpoint

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

Description

New-AzStorageContext cmdlet은 Azure Storage 컨텍스트를 만듭니다. 스토리지 컨텍스트의 기본 인증은 저장소 계정 이름만 입력하는 경우 OAuth(Microsoft Entra ID)입니다. 에서 Storage 서비스의 인증에 대한 세부 정보를 참조하세요 https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

예제

예제 1: 스토리지 계정 이름 및 키를 지정하여 컨텍스트 만들기

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

이 명령은 지정된 키를 사용하는 ContosoGeneral이라는 계정에 대한 컨텍스트를 만듭니다.

예제 2: 연결 문자열 지정하여 컨텍스트 만들기

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

이 명령은 ContosoGeneral 계정에 대해 지정된 연결 문자열 기반으로 컨텍스트를 만듭니다.

예제 3: 익명 스토리지 계정에 대한 컨텍스트 만들기

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

이 명령은 ContosoGeneral이라는 계정에 익명으로 사용할 컨텍스트를 만듭니다. 이 명령은 HTTP를 연결 프로토콜로 지정합니다.

예제 4: 로컬 개발 스토리지 계정을 사용하여 컨텍스트 만들기

New-AzStorageContext -Local

이 명령은 로컬 개발 스토리지 계정을 사용하여 컨텍스트를 만듭니다. 이 명령은 로컬 매개 변수를 지정합니다.

예제 5: 로컬 개발자 스토리지 계정에 대한 컨테이너 가져오기

New-AzStorageContext -Local | Get-AzStorageContainer

이 명령은 로컬 개발 스토리지 계정을 사용하여 컨텍스트를 만든 다음 파이프라인 연산자를 사용하여 Get-AzStorageContainer cmdlet에 새 컨텍스트를 전달합니다. 이 명령은 로컬 개발자 스토리지 계정에 대한 Azure Storage 컨테이너를 가져옵니다.

예제 6: 여러 컨테이너 가져오기

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

첫 번째 명령은 로컬 개발 스토리지 계정을 사용하여 컨텍스트를 만든 다음 해당 컨텍스트를 $Context 01 변수에 저장합니다. 두 번째 명령은 지정된 키를 사용하는 ContosoGeneral이라는 계정에 대한 컨텍스트를 만든 다음 해당 컨텍스트를 $Context 02 변수에 저장합니다. 최종 명령은 Get-AzStorageContainer를 사용하여 $Context 01 및 $Context 02에 저장된 컨텍스트에 대한 컨테이너를 가져옵니다.

예제 7: 엔드포인트를 사용하여 컨텍스트 만들기

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

이 명령은 지정된 스토리지 엔드포인트가 있는 Azure Storage 컨텍스트를 만듭니다. 이 명령은 지정된 키를 사용하는 ContosoGeneral이라는 계정에 대한 컨텍스트를 만듭니다.

예제 8: 지정된 환경을 사용하여 컨텍스트 만들기

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

이 명령은 지정된 Azure 환경이 있는 Azure Storage 컨텍스트를 만듭니다. 이 명령은 지정된 키를 사용하는 ContosoGeneral이라는 계정에 대한 컨텍스트를 만듭니다.

예제 9: SAS 토큰을 사용하여 컨텍스트 만들기

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

첫 번째 명령은 ContosoMain이라는 컨테이너에 대해 New-AzStorageContainerSASToken cmdlet을 사용하여 SAS 토큰을 생성한 다음 해당 토큰을 $SasToken 변수에 저장합니다. 이 토큰은 읽기, 추가, 업데이트 및 삭제 권한을 위한 것입니다. 두 번째 명령은 $SasToken 저장된 SAS 토큰을 사용하는 ContosoGeneral이라는 계정에 대한 컨텍스트를 만든 다음 해당 컨텍스트를 $Context 변수에 저장합니다. 최종 명령은 $Context 저장된 컨텍스트를 사용하여 ContosoMain이라는 컨테이너와 연결된 모든 Blob을 나열합니다.

예제 10: OAuth 인증을 사용하여 컨텍스트 만들기

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

이 명령은 OAuth(Microsoft Entra ID) 인증을 사용하여 컨텍스트를 만듭니다.

예제 11: 스토리지 계정 이름, 스토리지 계정 키 및 사용자 지정 Blob 엔드포인트를 지정하여 컨텍스트 만들기

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

이 명령은 계정의 키와 지정된 Blob 엔드포인트를 사용하여 myaccountname이라는 계정에 대한 컨텍스트를 만듭니다.

예제 12: 지정된 Blob 엔드포인트를 사용하여 익명 스토리지 계정에 대한 컨텍스트 만들기

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

이 명령은 지정된 Blob 엔드포인트를 사용하여 myaccountname이라는 계정에 익명으로 사용하기 위한 컨텍스트를 만듭니다.

예제 13: 지정된 엔드포인트가 있는 SAS 토큰을 사용하여 컨텍스트 만들기

$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/"

첫 번째 명령은 MyContainer라는 컨테이너에 대해 New-AzStorageContainerSASToken cmdlet을 사용하여 SAS 토큰을 생성한 다음 해당 토큰을 $SasToken 변수에 저장합니다. 두 번째 명령은 SAS 토큰 및 지정된 Blob 엔드포인트, 테이블 엔드포인트, 파일 엔드포인트 및 큐 엔드포인트를 사용하는 컨텍스트를 만듭니다.

예제 14: 지정된 Blob 엔드포인트에서 OAuth 인증을 사용하여 컨텍스트 만들기

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

이 명령은 지정된 Blob 엔드포인트에서 OAuth 인증을 사용하여 컨텍스트를 만듭니다.

예제 15: 파일 서비스에서 OAuth 인증을 사용하여 컨텍스트 만들기

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

이 명령은 파일 서비스에서 OAuth(Microsoft Entra ID) 인증을 사용하는 컨텍스트를 만듭니다. 파일 서비스에 OAuth(Microsoft Entra ID) 인증을 사용하려면 '-EnableFileBackupRequestIntent' 매개 변수가 필요합니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

매개 변수

-Anonymous

이 cmdlet은 익명 로그온을 위한 Azure Storage 컨텍스트를 만듭니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

AnonymousAccount
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountEnvironment
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountServiceEndpoint
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-BlobEndpoint

Azure Storage Blob 서비스 엔드포인트

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

AccountNameAndKeyServiceEndpoint
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ConnectionString

Azure Storage 컨텍스트에 대한 연결 문자열 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ConnectionString
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-EnableFileBackupRequestIntent

파일용 OAuth(Microsoft Entra ID) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OAuthAccount
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountEnvironment
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Endpoint

Azure Storage 컨텍스트에 대한 엔드포인트를 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OAuthAccount
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKey
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccount
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasToken
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Environment

Azure 환경을 지정합니다. 이 매개 변수에 허용되는 값은 AzureCloud 및 AzureChinaCloud입니다. 자세한 내용은 Get-Help Get-AzEnvironment입력합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:이름, EnvironmentName

매개 변수 집합

AccountNameAndKeyEnvironment
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False
AnonymousAccountEnvironment
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-FileEndpoint

Azure Storage 파일 서비스 엔드포인트

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

AccountNameAndKeyServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasTokenServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Local

이 cmdlet은 로컬 개발 스토리지 계정을 사용하여 컨텍스트를 만듭니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

LocalDevelopment
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Protocol

프로토콜 전송(https/http).

매개 변수 속성

형식:String
Default value:None
허용되는 값:Http, Https
와일드카드 지원:False
DontShow:False

매개 변수 집합

OAuthAccount
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKey
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKeyEnvironment
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccount
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountEnvironment
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasToken
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountEnvironment
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-QueueEndpoint

Azure Storage 큐 서비스 엔드포인트

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

AccountNameAndKeyServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasTokenServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SasToken

컨텍스트에 대한 SAS(공유 액세스 서명) 토큰을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

SasToken
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasTokenWithAzureEnvironment
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasTokenServiceEndpoint
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-StorageAccountKey

Azure Storage 계정 키를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 키에 대한 컨텍스트를 만듭니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

AccountNameAndKey
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKeyEnvironment
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKeyServiceEndpoint
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-StorageAccountName

Azure Storage 계정 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 계정에 대한 컨텍스트를 만듭니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OAuthAccount
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKey
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKeyEnvironment
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccount
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountEnvironment
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasToken
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasTokenWithAzureEnvironment
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountEnvironment
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AccountNameAndKeyServiceEndpoint
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-TableEndpoint

Azure Storage Table Service 엔드포인트

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

AccountNameAndKeyServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
SasTokenServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
AnonymousAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-UseConnectedAccount

이 cmdlet은 OAuth(Microsoft Entra ID) 인증을 사용하여 Azure Storage 컨텍스트를 만듭니다. cmdlet은 다른 인증을 지정하지 않은 경우 기본적으로 OAuth 인증을 사용합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

OAuthAccount
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountEnvironment
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
OAuthAccountServiceEndpoint
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

출력

AzureStorageContext