New-AzStorageContext
Создает контекст службы хранилища Azure.
Синтаксис
OAuthAccount (по умолчанию)
New-AzStorageContext
[-StorageAccountName] <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-Endpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKey
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AccountNameAndKeyEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-Environment <String>
[-Protocol <String>]
[<CommonParameters>]
AnonymousAccount
New-AzStorageContext
[-StorageAccountName] <String>
[-Anonymous]
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
AnonymousAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-Anonymous]
[-Protocol <String>]
[<CommonParameters>]
SasToken
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
[-Protocol <String>]
[-Endpoint <String>]
[<CommonParameters>]
SasTokenWithAzureEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-SasToken <String>
-Environment <String>
[<CommonParameters>]
OAuthAccountEnvironment
New-AzStorageContext
[-StorageAccountName] <String>
-Environment <String>
[-UseConnectedAccount]
[-Protocol <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
AccountNameAndKeyServiceEndpoint
New-AzStorageContext
[-StorageAccountName] <String>
[-StorageAccountKey] <String>
-BlobEndpoint <String>
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
OAuthAccountServiceEndpoint
New-AzStorageContext
[[-StorageAccountName] <String>]
[-UseConnectedAccount]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[-EnableFileBackupRequestIntent]
[<CommonParameters>]
SasTokenServiceEndpoint
New-AzStorageContext
-SasToken <String>
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
ConnectionString
New-AzStorageContext
-ConnectionString <String>
[<CommonParameters>]
LocalDevelopment
New-AzStorageContext
[-Local]
[<CommonParameters>]
AnonymousAccountServiceEndpoint
New-AzStorageContext
[-Anonymous]
[-BlobEndpoint <String>]
[-FileEndpoint <String>]
[-QueueEndpoint <String>]
[-TableEndpoint <String>]
[<CommonParameters>]
Описание
Примеры
Пример 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 с помощью оператора конвейера.
Команда получает контейнер службы хранилища Azure для локальной учетной записи хранения разработчика.
Пример 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.
Последняя команда получает контейнеры для контекстов, хранящихся в $Context 01 и $Context 02, с помощью Get-AzStorageContainer .
Пример 7. Создание контекста с конечной точкой
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"
Эта команда создает контекст службы хранилища Azure, имеющий указанную конечную точку хранилища.
Команда создает контекст для учетной записи ContosoGeneral, которая использует указанный ключ.
Пример 8. Создание контекста с указанной средой
New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"
Эта команда создает контекст службы хранилища Azure, имеющий указанную среду Azure.
Команда создает контекст для учетной записи ContosoGeneral, которая использует указанный ключ.
Пример 9. Создание контекста с помощью маркера SAS
$SasToken = New-AzStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
$Context | Get-AzStorageBlob -Container "ContosoMain"
Первая команда создает маркер SAS с помощью командлета New-AzStorageContainerSASToken для контейнера с именем ContosoMain, а затем сохраняет этот маркер в переменной $SasToken.
Этот маркер предназначен для разрешений на чтение, добавление, обновление и удаление.
Вторая команда создает контекст для учетной записи ContosoGeneral, которая использует маркер SAS, хранящийся в $SasToken, а затем сохраняет этот контекст в переменной $Context.
Последняя команда перечисляет все большие двоичные объекты, связанные с контейнером ContosoMain, с помощью контекста, хранящегося в $Context.
Пример 10. Создание контекста с помощью проверки подлинности OAuth
Connect-AzAccount
$Context = New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount
Эта команда создает контекст с помощью проверки подлинности OAuth (Идентификатор Microsoft Entra).
Пример 11. Создание контекста путем указания имени учетной записи хранения, ключа учетной записи хранения и пользовательской конечной точки BLOB-объектов
New-AzStorageContext -StorageAccountName "myaccountname" -StorageAccountKey "< Storage Key for myaccountname ends with == >" -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Эта команда создает контекст для учетной записи с именем myaccountname с ключом для учетной записи и указанной конечной точкой большого двоичного объекта.
Пример 12. Создание контекста для анонимной учетной записи хранения с указанной конечной точкой BLOB-объектов
New-AzStorageContext -Anonymous -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Эта команда создает контекст для анонимного использования для учетной записи с именем 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/"
Первая команда создает маркер SAS с помощью командлета New-AzStorageContainerSASToken для контейнера с именем MyContainer, а затем сохраняет этот маркер в переменной $SasToken.
Вторая команда создает контекст, использующий маркер SAS и указанную конечную точку BLOB-объекта, конечную точку таблицы, конечную точку файла и конечную точку очереди.
Пример 14. Создание контекста с помощью проверки подлинности OAuth с указанной конечной точкой большого двоичного объекта
New-AzStorageContext -UseConnectedAccount -BlobEndpoint "https://myaccountname.blob.core.windows.net/"
Эта команда создает контекст с помощью проверки подлинности OAuth с указанной конечной точкой большого двоичного объекта.
Пример 15. Создание контекста с помощью проверки подлинности OAuth в службе файлов
New-AzStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount -EnableFileBackupRequestIntent
Эта команда создает контекст для использования проверки подлинности OAuth (Идентификатор Microsoft Entra) в службе файлов.
Параметр -EnableFileBackupRequestIntent требуется для использования проверки подлинности OAuth (Идентификатор Microsoft Entra) для службы файлов. Это позволит обойти все проверки разрешений на уровне файлов и каталогов и разрешить доступ на основе разрешенных действий с данными, даже если для этих файлов и каталогов существуют списки управления доступом.
Параметры
-Anonymous
Указывает, что этот командлет создает контекст службы хранилища Azure для анонимного входа.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
AnonymousAccount
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountEnvironment
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountServiceEndpoint
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-BlobEndpoint
Конечная точка службы BLOB-объектов хранилища Azure
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
AccountNameAndKeyServiceEndpoint
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-ConnectionString
Указывает строку подключения для контекста службы хранилища Azure.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
ConnectionString
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-EnableFileBackupRequestIntent
Обязательный параметр для использования с проверкой подлинности OAuth (Идентификатор Microsoft Entra) для файлов. Это позволит обойти все проверки разрешений на уровне файлов и каталогов и разрешить доступ на основе разрешенных действий с данными, даже если для этих файлов и каталогов существуют списки управления доступом.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
OAuthAccount
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountEnvironment
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Endpoint
Указывает конечную точку для контекста службы хранилища Azure.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
OAuthAccount
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKey
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccount
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasToken
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Environment
Указывает среду Azure.
Допустимыми значениями этого параметра являются AzureCloud и AzureChinaCloud.
Для получения дополнительной информации введите Get-Help Get-AzEnvironment
.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Aliases: Имя, Имя среды
Наборы параметров
AccountNameAndKeyEnvironment
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
AnonymousAccountEnvironment
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: True
Значение из оставшихся аргументов: False
-FileEndpoint
Конечная точка службы файловой службы хранилища Azure
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
AccountNameAndKeyServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasTokenServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Local
Указывает, что этот командлет создает контекст с помощью локальной учетной записи хранения разработки.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
LocalDevelopment
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-Protocol
Протокол передачи (https/http).
Свойства параметра
Тип: String
Default value: None
Допустимые значения: Http, Https
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
OAuthAccount
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKey
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKeyEnvironment
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccount
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountEnvironment
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasToken
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountEnvironment
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-QueueEndpoint
Конечная точка службы очередей службы хранилища Azure
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
AccountNameAndKeyServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasTokenServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-SasToken
Указывает маркер подписанного URL-адреса (SAS) для контекста.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
SasToken
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasTokenWithAzureEnvironment
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasTokenServiceEndpoint
Position: Named
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-StorageAccountKey
Указывает ключ учетной записи хранения Azure.
Этот командлет создает контекст для ключа, указанного этим параметром.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
AccountNameAndKey
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKeyEnvironment
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKeyServiceEndpoint
Position: 1
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-StorageAccountName
Указывает имя учетной записи хранения Azure.
Этот командлет создает контекст для учетной записи, указанной этим параметром.
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
OAuthAccount
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKey
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKeyEnvironment
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccount
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountEnvironment
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasToken
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasTokenWithAzureEnvironment
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountEnvironment
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AccountNameAndKeyServiceEndpoint
Position: 0
Обязательно: True
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-TableEndpoint
Конечная точка службы таблиц хранилища Azure
Свойства параметра
Тип: String
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
AccountNameAndKeyServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
SasTokenServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
AnonymousAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
-UseConnectedAccount
Указывает, что этот командлет создает контекст службы хранилища Azure с проверкой подлинности OAuth (Идентификатор Microsoft Entra).
Командлет будет использовать проверку подлинности OAuth по умолчанию, если другая проверка подлинности не указана.
Свойства параметра
Тип: SwitchParameter
Default value: None
Поддерживаются подстановочные знаки: False
DontShow: False
Наборы параметров
OAuthAccount
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountEnvironment
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
OAuthAccountServiceEndpoint
Position: Named
Обязательно: False
Значение из конвейера: False
Значение из конвейера по имени свойства: False
Значение из оставшихся аргументов: False
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters .
Выходные данные