New-AzStorageContext

Модуль:

Az.Storage

Создает контекст службы хранилища Azure.

Синтаксис

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   [-Endpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-Anonymous]
   [-Protocol <String>]
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   [-Protocol <String>]
   [-Endpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   -SasToken <String>
   -Environment <String>
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-UseConnectedAccount]
   [-Protocol <String>]
   -Environment <String>
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

New-AzStorageContext
   [-StorageAccountName] <String>
   [-StorageAccountKey] <String>
   -BlobEndpoint <String>
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   -SasToken <String>
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   -ConnectionString <String>
   [<CommonParameters>]

New-AzStorageContext
   [-Local]
   [<CommonParameters>]

New-AzStorageContext
   [-Anonymous]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [<CommonParameters>]

New-AzStorageContext
   [-UseConnectedAccount]
   [-BlobEndpoint <String>]
   [-FileEndpoint <String>]
   [-QueueEndpoint <String>]
   [-TableEndpoint <String>]
   [-EnableFileBackupRequestIntent]
   [<CommonParameters>]

Описание

Командлет New-AzStorageContext создает контекст служба хранилища Azure. Проверка подлинности по умолчанию контекста хранилища — OAuth (идентификатор Microsoft Entra ID), если только входное имя учетной записи хранения. Дополнительные сведения о проверке подлинности службы хранилища см. в https://learn.microsoft.com/rest/api/storageservices/authorization-for-the-azure-storage-services.

Примеры

Пример 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
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BlobEndpoint

Конечная точка службы BLOB-объектов хранилища Azure

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

-ConnectionString

Задает строка подключения для контекста служба хранилища Azure.

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

-EnableFileBackupRequestIntent

Обязательный параметр для использования с проверкой подлинности OAuth (Идентификатор Microsoft Entra) для файлов. Это позволит обойти все проверки разрешений на уровне файлов и каталогов и разрешить доступ на основе разрешенных действий с данными, даже если для этих файлов и каталогов существуют списки управления доступом.

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

-Endpoint

Указывает конечную точку для контекста служба хранилища Azure.

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

-Environment

Указывает среду Azure. Допустимыми значениями этого параметра являются AzureCloud и AzureChinaCloud. Для получения дополнительных сведений введите Get-Help Get-AzEnvironment.

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

-FileEndpoint

Конечная точка службы файловой службы хранилища Azure

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

-Local

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

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

-Protocol

Протокол передачи (https/http).

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

-QueueEndpoint

Конечная точка службы очередей службы хранилища Azure

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

-SasToken

Указывает маркер подписанного URL-адреса (SAS) для контекста.

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

-StorageAccountKey

Указывает ключ учетной записи служба хранилища Azure. Этот командлет создает контекст для ключа, указанного этим параметром.

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

-StorageAccountName

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

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

-TableEndpoint

Конечная точка службы таблиц хранилища Azure

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

-UseConnectedAccount

Указывает, что этот командлет создает контекст служба хранилища Azure с проверкой подлинности OAuth (Идентификатор Microsoft Entra ID). Командлет будет использовать проверку подлинности OAuth по умолчанию, если другая проверка подлинности не указана.

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

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

String

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

AzureStorageContext

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

• Get-AzStorageBlob
• New-AzStorageContainerSASToken;