New-AzStorageContext
Создает контекст службы хранилища 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-Az служба хранилища Context создает контекст служба хранилища 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-Az служба хранилища Container с помощью оператора конвейера. Команда получает контейнер служба хранилища 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-Az служба хранилища Container.
Пример 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-Az служба хранилища ContainerSASToken для контейнера с именем 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-Az служба хранилища ContainerSASToken для контейнера с именем 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 для анонимного входа.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BlobEndpoint
Конечная точка службы BLOB-объектов хранилища Azure
| Type: | String |
| 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 |
-EnableFileBackupRequestIntent
Обязательный параметр для использования с проверкой подлинности OAuth (Идентификатор Microsoft Entra) для файлов. Это позволит обойти все разрешения на уровне файлов и каталогов, проверка и разрешить доступ на основе разрешенных действий с данными, даже если для этих файлов и каталогов есть списки управления доступом.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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-AzEnvironment.
| Type: | String |
| Aliases: | Name, EnvironmentName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileEndpoint
Конечная точка службы файловой службы хранилища Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-QueueEndpoint
Конечная точка службы очередей службы хранилища Azure
| Type: | String |
| 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 |
-TableEndpoint
Конечная точка службы таблиц хранилища Azure
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseConnectedAccount
Указывает, что этот командлет создает контекст служба хранилища Azure с проверкой подлинности OAuth (Идентификатор Microsoft Entra ID). Командлет будет использовать проверку подлинности OAuth по умолчанию, если другая проверка подлинности не указана.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Выходные данные
Связанные ссылки
Azure PowerShell
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по