New-AzStorageFileSASToken
Создает маркер подписанного URL-адреса для файла хранилища.
Синтаксис
NameSasPermission
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
NameSasPolicy
New-AzStorageFileSASToken
[-ShareName] <String>
[-Path] <String>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPermission
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
[-Permission <String>]
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
FileSasPolicy
New-AzStorageFileSASToken
-ShareFileClient <ShareFileClient>
-Policy <String>
[-Protocol <String>]
[-IPAddressOrRange <String>]
[-StartTime <DateTime>]
[-ExpiryTime <DateTime>]
[-FullUri]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Описание
Командлет New-AzStorageFileSASToken создает маркер подписанного URL-адреса для файла службы хранилища Azure.
Примеры
Пример 1. Создание маркера подписанного URL-адреса с полными разрешениями на файл
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd"
Эта команда создает маркер подписанного URL-адреса с полными разрешениями для файла с именем FilePath.
Пример 2. Создание маркера подписанного URL-адреса с ограничением времени
$StartTime = Get-Date
$EndTime = $StartTime.AddHours(2.0)
New-AzStorageFileSASToken -ShareName "ContosoShare" -Path "FilePath" -Permission "rwd" -StartTime $StartTime -ExpiryTime $EndTime
Первая команда создает объект DateTime с помощью командлета Get-Date.
Команда сохраняет текущее время в переменной $StartTime.
Вторая команда добавляет два часа к объекту в $StartTime, а затем сохраняет результат в переменной $EndTime.
Этот объект — это время в течение двух часов в будущем.
Третья команда создает маркер подписанного URL-адреса, имеющий указанные разрешения.
Этот маркер становится допустимым в текущее время.
Маркер остается допустимым до тех пор, пока не будет храниться в $EndTime.
Параметры
-Context
Указывает контекст службы хранилища Azure.
Чтобы получить контекст, используйте командлет New-AzStorageContext.
Свойства параметра
Тип: IStorageContext
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.
Свойства параметра
Тип: IAzureContextContainer
Default value: None Поддерживаются подстановочные знаки: False DontShow: False Aliases: AzureRmContext, AzureCredential
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-ExpiryTime
Указывает время, в течение которого подпись общего доступа становится недопустимой.
Свойства параметра
Тип: Nullable<T> [ DateTime ]
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-FullUri
Указывает, что этот командлет возвращает полный URI BLOB-объектов и маркер подписанного URL-адреса.
Свойства параметра
Тип: SwitchParameter
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-IPAddressOrRange
Указывает IP-адрес или диапазон IP-адресов, от которых следует принимать запросы, например 168.1.5.65 или 168.1.5.60-168.1.5.70.
Диапазон включаем.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Path
Указывает путь к файлу относительно общей папки хранилища.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
NameSasPermission
Position: 1 Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
NameSasPolicy
Position: 1 Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-Permission
Указывает разрешения для файла хранилища.
Важно отметить, что это строка, например rwd (для чтения, записи и удаления).
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
NameSasPermission
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
FileSasPermission
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Policy
Задает хранимую политику доступа для файла.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
NameSasPolicy
Position: Named Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
FileSasPolicy
Position: Named Обязательно: True Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-Protocol
Указывает протокол, разрешенный для запроса.
Допустимые значения для этого параметра:
HttpsOnly
HttpsOrHttp Значение по умолчанию — HttpsOrHttp.
Свойства параметра
Тип: String
Default value: None Допустимые значения: HttpsOnly, HttpsOrHttp Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
-ShareFileClient
Экземпляр ShareFileClient для представления файла для получения маркера SAS.
Свойства параметра
Тип: ShareFileClient
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
FileSasPermission
Position: Named Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
FileSasPolicy
Position: Named Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-ShareName
Указывает имя общей папки хранилища.
Свойства параметра
Тип: String
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
NameSasPermission
Position: 0 Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
NameSasPolicy
Position: 0 Обязательно: True Значение из конвейера: True Значение из конвейера по имени свойства: True Значение из оставшихся аргументов: False
-StartTime
Указывает время, в течение которого подпись общего доступа становится допустимой.
Свойства параметра
Тип: Nullable<T> [ DateTime ]
Default value: None Поддерживаются подстановочные знаки: False DontShow: False
Наборы параметров
(All)
Position: Named Обязательно: False Значение из конвейера: False Значение из конвейера по имени свойства: False Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные
