New-AzureStorageFileSASToken

Модуль:

Azure.Storage

Создает маркер подписи общего доступа для файла служба хранилища.

Предупреждение

Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureStorageFileSASToken
   [-ShareName] <String>
   [-Path] <String>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureStorageFileSASToken
   -File <CloudFile>
   [-Permission <String>]
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzureStorageFileSASToken
   -File <CloudFile>
   -Policy <String>
   [-Protocol <SharedAccessProtocol>]
   [-IPAddressOrRange <String>]
   [-StartTime <DateTime>]
   [-ExpiryTime <DateTime>]
   [-FullUri]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет New-Azure служба хранилища FileSASToken создает маркер подписи общего доступа для файла служба хранилища Azure.

Примеры

Пример 1. Создание маркера подписанного URL-адреса с полными разрешениями на файл

PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"

Эта команда создает маркер подписанного URL-адреса с полными разрешениями для файла с именем FilePath.

Пример 2. Создание маркера подписанного URL-адреса с ограничением времени

PS C:\> $StartTime = Get-Date
PS C:\> $EndTime = $StartTime.AddHours(2.0)
PS C:\> New-AzureStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime

Первая команда создает объект DateTime с помощью командлета Get-Date. Команда сохраняет текущее время в переменной $StartTime. Вторая команда добавляет два часа к объекту в $StartTime, а затем сохраняет результат в переменной $EndTime. Этот объект — это время в течение двух часов в будущем. Третья команда создает маркер подписанного URL-адреса, имеющий указанные разрешения. Этот маркер становится допустимым в текущее время. Маркер остается допустимым до тех пор, пока не будет храниться в $EndTime.

Параметры

-Context

Указывает контекст служба хранилища Azure. Чтобы получить контекст, используйте командлет New-Azure служба хранилища Context.

Тип:	IStorageContext
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExpiryTime

Указывает время, в течение которого подпись общего доступа становится недопустимой.

Тип:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-File

Указывает объект CloudFile . Вы можете создать облачный файл или получить его с помощью командлета Get-Azure служба хранилища File.

Тип:	CloudFile
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-FullUri

Указывает, что этот командлет возвращает полный URI BLOB-объектов и маркер подписанного URL-адреса.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IPAddressOrRange

Указывает IP-адрес или диапазон IP-адресов, от которых следует принимать запросы, например 168.1.5.65 или 168.1.5.60-168.1.5.70. Диапазон включаем.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Path

Указывает путь к файлу относительно служба хранилища общей папки.

Тип:	String
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Permission

Задает разрешения для файла служба хранилища. Важно отметить, что это строка, например rwd (для чтения, записи и удаления).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Policy

Задает хранимую политику доступа для файла.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Protocol

Указывает протокол, разрешенный для запроса. Допустимые значения для этого параметра:

• HttpsOnly
• HttpsOrHttp Значение по умолчанию — HttpsOrHttp.

Тип:	Nullable<T>[SharedAccessProtocol]
Допустимые значения:	HttpsOnly, HttpsOrHttp
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ShareName

Указывает имя служба хранилища общей папки.

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-StartTime

Указывает время, в течение которого подпись общего доступа становится допустимой.

Тип:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

String

CloudFile

IStorageContext

Параметры: Context (ByValue)

Выходные данные

String

Связанные ссылки

• New-AzureStorageContext
• New-AzureStorageShareSASToken