New-AzStorageContainerSASToken

Azure Storage 컨테이너에 대한 SAS 토큰을 생성합니다.

Syntax

New-AzStorageContainerSASToken
   [-Name] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzStorageContainerSASToken
   [-Name] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-EncryptionScope <String>]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzStorageContainerSASToken cmdlet은 Azure Storage 컨테이너에 대한 SAS(공유 액세스 서명) 토큰을 생성합니다.

예제

예제 1: 전체 컨테이너 권한이 있는 컨테이너 SAS 토큰 생성

New-AzStorageContainerSASToken -Name "Test" -Permission rwdl

이 예제에서는 전체 컨테이너 권한이 있는 컨테이너 SAS 토큰을 생성합니다.

예제 2: 파이프라인을 통해 여러 컨테이너 SAS 토큰 생성

Get-AzStorageContainer -Container test* | New-AzStorageContainerSASToken -Permission rwdl

이 예제에서는 파이프라인을 사용하여 여러 컨테이너 SAS 토큰을 생성합니다.

예제 3: 공유 액세스 정책을 사용하여 컨테이너 SAS 토큰 생성

New-AzStorageContainerSASToken -Name "Test" -Policy "PolicyName"

이 예제에서는 공유 액세스 정책을 사용하여 컨테이너 SAS 토큰을 생성합니다.

예제 3: OAuth 인증을 기반으로 스토리지 컨텍스트를 사용하여 사용자 ID 컨테이너 SAS 토큰 생성

$ctx = New-AzStorageContext -StorageAccountName $accountName -UseConnectedAccount
$StartTime = Get-Date
$EndTime = $startTime.AddDays(6)
New-AzStorageContainerSASToken -Name "ContainerName" -Permission rwd -StartTime $StartTime -ExpiryTime $EndTime -context $ctx

이 예제에서는 OAuth 인증을 기반으로 스토리지 컨텍스트를 사용하여 사용자 ID 컨테이너 SAS 토큰을 생성합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-Context

Azure Storage 컨텍스트를 지정합니다. New-AzStorageContext cmdlet을 사용하여 만들 수 있습니다. 스토리지 컨텍스트가 OAuth 인증을 기반으로 하는 경우 사용자 ID 컨테이너 SAS 토큰을 생성합니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionScope

이 SAS URI로 권한이 부여된 요청을 보낼 때 사용할 암호화 범위입니다.

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

-ExpiryTime

공유 액세스 서명이 유효하지 않은 시간을 지정합니다. 사용자가 시작 시간을 설정하지만 만료 시간이 아닌 경우 만료 시간은 시작 시간과 1시간으로 설정됩니다. 시작 시간이나 만료 시간을 지정하지 않으면 만료 시간이 현재 시간과 1시간으로 설정됩니다. 스토리지 컨텍스트가 OAuth 인증을 기반으로 하는 경우 만료 시간은 현재 시간으로부터 7일 이내여야 하며 현재 시간보다 빠르지 않아야 합니다.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FullUri

이 cmdlet은 전체 Blob URI 및 공유 액세스 서명 토큰을 반환합니다.

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

-IPAddressOrRange

요청을 수락할 IP 주소 또는 범위(예: 168.1.5.65 또는 168.1.5.60-168.1.5.70)를 지정합니다. 범위는 포함됩니다.

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

-Name

Azure Storage 컨테이너 이름을 지정합니다.

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

-Permission

스토리지 컨테이너에 대한 권한을 지정합니다. 읽기, 쓰기 및 삭제와 같은 rwd 문자열이라는 점에 유의해야 합니다. 컨테이너 리소스 종류에 대해 지원되는 권한은 여기에 설명되어 있습니다.

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

-Policy

Azure 저장된 액세스 정책을 지정합니다.

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

-Protocol

요청에 허용되는 프로토콜을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • HttpsOnly
  • HttpsOrHttp 기본값은 HttpsOrHttp입니다.
Type:Nullable<T>[SharedAccessProtocol]
Accepted values:HttpsOnly, HttpsOrHttp
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartTime

공유 액세스 서명이 유효한 시간을 지정합니다.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

IStorageContext

출력

String