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
예제
예제 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 컨텍스트를 만듭니다.
매개 변수 속성
매개 변수 집합
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이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.
매개 변수 속성
매개 변수 집합
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은 로컬 개발 스토리지 계정을 사용하여 컨텍스트를 만듭니다.
매개 변수 속성
매개 변수 집합
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 인증을 사용합니다.
매개 변수 속성
매개 변수 집합
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 를 참조하세요.
출력