New-AzStorageContext

참조

모듈:: Az.Storage

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

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-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 enpoint를 사용하여 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 컨텍스트를 만듭니다.

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

-BlobEndpoint

Azure Storage Blob 서비스 엔드포인트

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

-ConnectionString

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

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

-EnableFileBackupRequestIntent

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

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

-Endpoint

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

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

-Environment

Azure 환경을 지정합니다. 이 매개 변수에 허용되는 값은 AzureCloud 및 AzureChinaCloud입니다. 자세한 내용은 다음을 입력합니다 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 Storage 파일 서비스 엔드포인트

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

-Local

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

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

-Protocol

프로토콜 전송(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 Storage 큐 서비스 엔드포인트

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

-SasToken

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

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

-StorageAccountKey

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

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

-StorageAccountName

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

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

-TableEndpoint

Azure Storage Table Service 엔드포인트

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

-UseConnectedAccount

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

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

입력

String

출력

AzureStorageContext

New-AzStorageContext

Syntax

Description

예제

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

매개 변수

-Anonymous

-BlobEndpoint

-ConnectionString

-EnableFileBackupRequestIntent

-Endpoint

-Environment

-FileEndpoint

-Local

-Protocol

-QueueEndpoint

-SasToken

-StorageAccountKey

-StorageAccountName

-TableEndpoint

-UseConnectedAccount

입력

출력

피드백

추가 리소스

New-AzStorageContext

Syntax

Description

예제

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

매개 변수

-Anonymous

-BlobEndpoint

-ConnectionString

-EnableFileBackupRequestIntent

-Endpoint

-Environment

-FileEndpoint

-Local

-Protocol

-QueueEndpoint

-SasToken

-StorageAccountKey

-StorageAccountName

-TableEndpoint

-UseConnectedAccount

입력

출력

관련 링크

피드백

추가 리소스