New-AzureStorageContext

Модуль:

Azure.Storage

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

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

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

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

Синтаксис

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

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

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

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

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

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

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

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

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

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

Описание

Командлет New-Azure служба хранилища Context создает контекст служба хранилища Azure.

Примеры

Пример 1. Создание контекста путем указания имени учетной записи хранения и ключа

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"

Эта команда создает контекст для учетной записи ContosoGeneral, которая использует указанный ключ.

Пример 2. Создание контекста путем указания строка подключения

C:\PS>New-AzureStorageContext -ConnectionString "DefaultEndpointsProtocol=https;AccountName=ContosoGeneral;AccountKey=< Storage Key for ContosoGeneral ends with == >;"

Эта команда создает контекст на основе указанного строка подключения учетной записи ContosoGeneral.

Пример 3. Создание контекста для анонимной учетной записи хранения

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -Anonymous -Protocol "http"

Эта команда создает контекст для анонимного использования для учетной записи ContosoGeneral. Команда указывает HTTP в качестве протокола подключения.

Пример 4. Создание контекста с помощью локальной учетной записи хранения разработки

C:\PS>New-AzureStorageContext -Local

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

Пример 5. Получение контейнера для локальной учетной записи хранения разработчика

C:\PS>New-AzureStorageContext -Local | Get-AzureStorageContainer

Эта команда создает контекст с помощью локальной учетной записи хранения разработки, а затем передает новый контекст командлету Get-Azure служба хранилища Container с помощью оператора конвейера. Команда получает контейнер служба хранилища Azure для локальной учетной записи хранения разработчика.

Пример 6. Получение нескольких контейнеров

C:\PS>$Context01 = New-AzureStorageContext -Local 
PS C:\> $Context02 = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
PS C:\> ($Context01, $Context02) | Get-AzureStorageContainer

Первая команда создает контекст с помощью локальной учетной записи хранения разработки, а затем сохраняет этот контекст в переменной $Context 01. Вторая команда создает контекст для учетной записи ContosoGeneral, которая использует указанный ключ, а затем сохраняет этот контекст в переменной $Context 02. Последняя команда получает контейнеры для контекстов, хранящихся в $Context 01 и $Context 02 с помощью Get-Azure служба хранилища Container.

Пример 7. Создание контекста с конечной точкой

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Endpoint "contosoaccount.core.windows.net"

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

Пример 8. Создание контекста с указанной средой

C:\PS>New-AzureStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >" -Environment "AzureChinaCloud"

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

Пример 9. Создание контекста с помощью маркера SAS

C:\PS>$SasToken = New-AzureStorageContainerSASToken -Name "ContosoMain" -Permission "rad"
PS C:\> $Context = New-AzureStorageContext -StorageAccountName "ContosoGeneral" -SasToken $SasToken
PS C:\> $Context | Get-AzureStorageBlob -Container "ContosoMain"

Первая команда создает маркер SAS с помощью командлета New-Azure служба хранилища ContainerSASToken для контейнера с именем ContosoMain, а затем сохраняет этот маркер в переменной $SasToken. Этот маркер предназначен для разрешений на чтение, добавление, обновление и удаление. Вторая команда создает контекст для учетной записи ContosoGeneral, которая использует маркер SAS, хранящийся в $SasToken, а затем сохраняет этот контекст в переменной $Context. Последняя команда перечисляет все большие двоичные объекты, связанные с контейнером ContosoMain, с помощью контекста, хранящегося в $Context.

Пример 10. Создание контекста с помощью проверки подлинности OAuth

C:\PS>Connect-AzureRmAccount
C:\PS> $Context = New-AzureStorageContext -StorageAccountName "myaccountname" -UseConnectedAccount

Эта команда создает контекст с помощью проверки подлинности OAuth.

Параметры

-Anonymous

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

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

-ConnectionString

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

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

-Endpoint

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

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

-Environment

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

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

-Local

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

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

-Protocol

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

Type:	String
Accepted values:	Http, Https
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SasToken

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

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

-StorageAccountKey

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

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

-StorageAccountName

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

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

-UseConnectedAccount

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

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

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

String

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

AzureStorageContext

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

• Get-AzureStorageBlob
• New-AzureStorageContainerSASToken