Azure Data Lake Storage Gen2에서 PowerShell을 사용하여 디렉터리 및 파일 관리

이 문서에서는 PowerShell을 사용하여 계층 구조 네임스페이스가 있는 스토리지 계정에서 디렉터리 및 파일을 만들고 관리하는 방법을 보여 줍니다.

디렉터리 및 파일의 ACL(액세스 제어 목록)을 가져오거나 설정하고 업데이트하는 방법에 대한 자세한 내용은 을 사용하여 Azure Data Lake Storage Gen2 ACL 관리를 참조하세요.

참조 | Gen1과 Gen2 매핑 | 피드백 제공

필수 구성 요소

• Azure 구독 자세한 내용은 Azure 무료 평가판 가져오기 를 참조하세요.

• 계층 구조 네임스페이스가 사용하도록 설정된 스토리지 계정입니다. 이러한 지침에 따라 라이브러리를 만듭니다.

• .NET Framework 4.7.2 이상이 설치되어 있습니다. 자세한 내용은 .NET Framework 다운로드를 참조하세요.

• PowerShell 버전 5.1 이상

PowerShell 모듈 설치

1. 다음 명령을 사용하여 설치된 PowerShell 버전이 5.1 이상인지 확인합니다.

   echo $PSVersionTable.PSVersion.ToString()
   

   PowerShell 버전을 업그레이드하려면 기존 Windows PowerShell 업그레이드를 참조하세요.

2. Az.Storage 모듈을 설치합니다.

   Install-Module Az.Storage -Repository PSGallery -Force  
   

   PowerShell 모듈 설치 방법에 대한 자세한 내용은 Azure PowerShell 모듈 설치를 참조하세요.

계정에 연결

명령으로 스토리지 계정에 대해 권한 부여를 획득하는 방법을 선택합니다.

옵션 1: Microsoft Entra ID를 사용하여 권한 부여 획득

이 접근 방식을 사용할 때 시스템은 사용자 계정에 적절한 Azure RBAC(역할 기반 액세스 제어) 할당 및 ACL 권한이 포함되었는지 확인합니다.

1. Windows PowerShell 명령 창을 연 후 Connect-AzAccount 명령으로 Azure 구독에 로그인하고 화면 안내를 따릅니다.

   Connect-AzAccount
   

2. ID가 둘 이상의 구독에 연결되어 있으면 활성 구독을 디렉터리를 만들고 관리할 스토리지 계정의 구독으로 설정합니다. 이 예제에서는 <subscription-id> 자리 표시자 값을 해당 구독의 ID로 바꿉니다.

   Select-AzSubscription -SubscriptionId <subscription-id>
   

3. 스토리지 계정 컨텍스트를 가져옵니다.

   $ctx = New-AzStorageContext -StorageAccountName '<storage-account-name>' -UseConnectedAccount
   

옵션 2: 스토리지 계정 키를 사용하여 권한 부여 획득

이 방법에서는 시스템이 Azure RBAC 또는 ACL 권한을 확인하지 않습니다. 계정 키를 사용하여 스토리지 계정 컨텍스트를 가져옵니다.

$ctx = New-AzStorageContext -StorageAccountName '<storage-account-name>' -StorageAccountKey '<storage-account-key>'

컨테이너 만들기

컨테이너는 파일의 파일 시스템 역할을 합니다. New-AzStorageContainer cmdlet을 사용하여 만들 수 있습니다.

다음 예제에서는 my-file-system이라는 컨테이너를 만듭니다.

$filesystemName = "my-file-system"
New-AzStorageContainer -Context $ctx -Name $filesystemName

디렉터리 만들기

New-AzDataLakeGen2Item cmdlet을 사용하여 디렉터리 참조를 만듭니다.

이 예제에서는 my-directory라는 디렉터리를 컨테이너에 추가합니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -Directory

이 예제에서는 동일한 디렉터리를 추가하지만 사용 권한, umask, 속성 값 및 메타데이터 값도 설정합니다.

$dir = New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -Directory -Permission rwxrwxrwx -Umask ---rwx---  -Property @{"ContentEncoding" = "UDF8"; "CacheControl" = "READ"} -Metadata  @{"tag1" = "value1"; "tag2" = "value2" }

디렉터리 속성 표시

이 예제에서는 Get-AzDataLakeGen2Item cmdlet을 사용하여 디렉터리를 가져온 후 속성 값을 콘솔에 출력합니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
$dir =  Get-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname
$dir.ACL
$dir.Permissions
$dir.Group
$dir.Owner
$dir.Properties
$dir.Properties.Metadata

디렉터리 이름 바꾸기 또는 이동

Move-AzDataLakeGen2Item cmdlet을 사용하여 디렉터리의 이름을 바꾸거나 디렉터리를 이동합니다.

다음 예제에서는 디렉터리의 이름을 my-directory에서 my-new-directory로 바꿉니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
$dirname2 = "my-new-directory/"
Move-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -DestFileSystem $filesystemName -DestPath $dirname2

이 예제에서는 my-directory 디렉터리를 my-subdirectory 디렉터리의 하위 디렉터리인 my-directory-2로 이동합니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
$dirname2 = "my-directory-2/my-subdirectory/"
Move-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $dirname -DestFileSystem $filesystemName -DestPath $dirname2

디렉터리 삭제

Remove-AzDataLakeGen2Item cmdlet을 사용하여 디렉터리를 삭제합니다.

다음 예제에서는 my-directory라는 디렉터리를 삭제합니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
Remove-AzDataLakeGen2Item  -Context $ctx -FileSystem $filesystemName -Path $dirname

-Force 매개 변수를 사용하여 프롬프트 없이 파일을 제거할 수 있습니다.

디렉터리에서 다운로드

Get-AzDataLakeGen2ItemContent cmdlet을 사용하여 디렉터리에서 파일을 다운로드합니다.

다음 예제에서는 my-directory라는 디렉터리에서 upload.txt라는 파일을 다운로드합니다.

$filesystemName = "my-file-system"
$filePath = "my-directory/upload.txt"
$downloadFilePath = "download.txt"
Get-AzDataLakeGen2ItemContent -Context $ctx -FileSystem $filesystemName -Path $filePath -Destination $downloadFilePath

디렉터리 콘텐츠 나열

Get-AzDataLakeGen2ChildItem cmdlet을 사용하여 디렉터리의 콘텐츠를 나열합니다. 선택적 매개 변수인 -OutputUserPrincipalName을 사용하여 사용자의 개체 ID 대신 이름을 가져올 수 있습니다.

이 예제에서는 my-directory 디렉터리의 콘텐츠를 나열합니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
Get-AzDataLakeGen2ChildItem -Context $ctx -FileSystem $filesystemName -Path $dirname -OutputUserPrincipalName

다음 예제에는 디렉터리에 있는 각 항목의 ACL, Permissions, Group 및 Owner 속성이 나와 있습니다. -FetchProperty 매개 변수는 ACL 속성에 대한 값을 가져오는 데 필요합니다.

$filesystemName = "my-file-system"
$dirname = "my-directory/"
$properties = Get-AzDataLakeGen2ChildItem -Context $ctx -FileSystem $filesystemName -Path $dirname -Recurse -FetchProperty
$properties.ACL
$properties.Permissions
$properties.Group
$properties.Owner

디렉터리에 파일 업로드

New-AzDataLakeGen2Item cmdlet을 사용하여 디렉터리에 파일을 업로드합니다.

다음 예제에서는 upload.txt라는 파일을 my-directory라는 디렉터리에 업로드합니다.

$localSrcFile =  "upload.txt"
$filesystemName = "my-file-system"
$dirname = "my-directory/"
$destPath = $dirname + (Get-Item $localSrcFile).Name
New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $destPath -Source $localSrcFile -Force

이 예제에서는 동일한 파일을 업로드한 후 대상 파일의 사용 권한, umask, 속성 값 및 메타데이터 값을 설정합니다. 또한 이 예제에서는 이러한 값을 콘솔에 출력합니다.

$file = New-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $destPath -Source $localSrcFile -Permission rwxrwxrwx -Umask ---rwx--- -Property @{"ContentEncoding" = "UDF8"; "CacheControl" = "READ"} -Metadata  @{"tag1" = "value1"; "tag2" = "value2" }
$file1
$file1.Properties
$file1.Properties.Metadata

파일 속성 표시

이 예제에서는 Get-AzDataLakeGen2Item cmdlet을 사용하여 파일을 가져온 후 속성 값을 콘솔에 출력합니다.

$filepath =  "my-directory/upload.txt"
$filesystemName = "my-file-system"
$file = Get-AzDataLakeGen2Item -Context $ctx -FileSystem $filesystemName -Path $filepath
$file
$file.ACL
$file.Permissions
$file.Group
$file.Owner
$file.Properties
$file.Properties.Metadata

파일 삭제

Remove-AzDataLakeGen2Item cmdlet을 사용하여 파일을 삭제합니다.

이 예제에서는 upload.txt라는 파일을 삭제합니다.

$filesystemName = "my-file-system"
$filepath = "upload.txt"
Remove-AzDataLakeGen2Item  -Context $ctx -FileSystem $filesystemName -Path $filepath

-Force 매개 변수를 사용하여 프롬프트 없이 파일을 제거할 수 있습니다.

Gen1과 Gen2 매핑

다음 표에서는 Data Lake Storage Gen1에 사용되는 cmdlet이 Data Lake Storage Gen2 cmdlet에 매핑되는 방법을 보여 줍니다.

참고 항목

• 알려진 문제
• 스토리지 PowerShell cmdlet