New-AzStorageContext
Azure Storage 컨텍스트를 만듭니다.
구문
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 컨텍스트를 만듭니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-BlobEndpoint
Azure Storage Blob 서비스 엔드포인트
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ConnectionString
Azure Storage 컨텍스트에 대한 연결 문자열 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableFileBackupRequestIntent
파일용 OAuth(Microsoft Entra ID) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Endpoint
Azure Storage 컨텍스트에 대한 엔드포인트를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Environment
Azure 환경을 지정합니다.
이 매개 변수에 허용되는 값은 AzureCloud 및 AzureChinaCloud입니다.
자세한 내용은 다음을 입력합니다 Get-Help Get-AzEnvironment.
| 형식: | String |
| 별칭: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-FileEndpoint
Azure Storage 파일 서비스 엔드포인트
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Local
이 cmdlet은 로컬 개발 스토리지 계정을 사용하여 컨텍스트를 만듭니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Protocol
프로토콜 전송(https/http).
| 형식: | String |
| 허용되는 값: | Http, Https |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-QueueEndpoint
Azure Storage 큐 서비스 엔드포인트
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SasToken
컨텍스트에 대한 SAS(공유 액세스 서명) 토큰을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StorageAccountKey
Azure Storage 계정 키를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 키에 대한 컨텍스트를 만듭니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StorageAccountName
Azure Storage 계정 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 계정에 대한 컨텍스트를 만듭니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TableEndpoint
Azure Storage Table Service 엔드포인트
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseConnectedAccount
이 cmdlet은 OAuth(Microsoft Entra ID) 인증을 사용하여 Azure Storage 컨텍스트를 만듭니다. cmdlet은 다른 인증을 지정하지 않은 경우 기본적으로 OAuth 인증을 사용합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |