Set-AzureKeyVaultManagedStorageSasDefinition
Задает определение подписанного URL-адреса (SAS) с помощью Key Vault для заданной управляемой учетной записи служба хранилища Azure Key Vault.
Предупреждение
Модуль AzureRM PowerShell официально устарел с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.
Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.
Синтаксис
Set-AzureKeyVaultManagedStorageSasDefinition
[-VaultName] <String>
[-AccountName] <String>
[-Name] <String>
[-TemplateUri] <String>
[-SasType] <String>
[-Disable]
[-Tag <Hashtable>]
-ValidityPeriod <TimeSpan>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzureKeyVaultManagedStorageSasDefinition
[-InputObject] <PSKeyVaultManagedStorageAccountIdentityItem>
[-Name] <String>
[-TemplateUri] <String>
[-SasType] <String>
[-Disable]
[-Tag <Hashtable>]
-ValidityPeriod <TimeSpan>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Задает определение подписанного URL-адреса (SAS) с заданным управляемым служба хранилища Azure учетной записью Key Vault. Это также задает секрет, который можно использовать для получения маркера SAS для этого определения SAS. Маркер SAS создается с помощью этих параметров и активного ключа управляемого служба хранилища Azure учетной записи Key Vault.
Примеры
Пример 1. Установка определения SAS типа учетной записи и получение текущего маркера SAS на основе него
PS C:\> $sa = Get-AzureRmStorageAccount -Name mysa -ResourceGroupName myrg
PS C:\> $kv = Get-AzureRmKeyVault -VaultName mykv
PS C:\> Add-AzureKeyVaultManagedStorageAccount -VaultName $kv.VaultName -AccountName $sa.StorageAccountName -AccountResourceId $sa.Id -ActiveKeyName key1 -RegenerationPeriod 180
PS C:\> $sctx = New-AzureStorageContext -StorageAccountName $sa.StorageAccountName -Protocol Https -StorageAccountKey Key1
PS C:\> $start = [System.DateTime]::Now.AddDays(-1)
PS C:\> $end = [System.DateTime]::Now.AddMonths(1)
PS C:\> $at = New-AzureStorageAccountSasToken -Service blob,file,Table,Queue -ResourceType Service,Container,Object -Permission "racwdlup" -Protocol HttpsOnly -StartTime $start -ExpiryTime $end -Context $sctx
PS C:\> $sas = Set-AzureKeyVaultManagedStorageSasDefinition -AccountName $sa.StorageAccountName -VaultName $kv.VaultName -Name accountsas -TemplateUri $at -SasType 'account' -ValidityPeriod ([System.Timespan]::FromDays(30))
PS C:\> Get-AzureKeyVaultSecret -VaultName $kv.VaultName -Name $sas.Sid.Substring($sas.Sid.LastIndexOf('/')+1)
Задает определение SAS учетной записи "accountsas" в управляемой keyVault учетной записи хранения mysa в хранилище mykv. В частности, приведенная выше последовательность выполняет следующую команду:
- возвращает учетную запись хранения (предварительная версия)
- возвращает хранилище ключей (предварительно существующее)
- добавляет в хранилище учетную запись хранения, управляемую ключом KeyVault, задав Key1 активным ключом и периодом восстановления в течение 180 дней.
- задает контекст хранилища для указанной учетной записи хранения с ключом Key1
- создает маркер SAS учетной записи для служб BLOB-объектов, файлов, таблиц и очередей для типов ресурсов Службы, контейнера и объекта со всеми разрешениями по протоколу HTTPS и указанными датами начала и окончания.
- задает определение SAS, управляемого ключом KeyVault, в хранилище с шаблоном URI в качестве маркера SAS, созданного выше, типа SAS и допустимого в течение 30 дней.
- извлекает фактический маркер доступа из секрета KeyVault, соответствующего определению SAS.
Параметры
-AccountName
Имя управляемой учетной записи хранения Key Vault. Командлет создает полное доменное имя управляемой учетной записи хранения из имени хранилища, выбранной среды и имени учетной записи хранения.
Тип: | String |
Aliases: | StorageAccountName |
Position: | 1 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure
Тип: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Disable
Отключает использование определения SAS для создания маркера SAS.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Управляемый служба хранилища Account-объект.
Тип: | PSKeyVaultManagedStorageAccountIdentityItem |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Name
служба хранилища имя определения sas. Командлет создает полное доменное имя определения sas хранилища из имени хранилища, выбранной в настоящее время среды, имени учетной записи хранения и имени определения sas.
Тип: | String |
Aliases: | SasDefinitionName |
Position: | 2 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SasType
служба хранилища тип SAS.
Тип: | String |
Position: | 4 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Tag
Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}
Тип: | Hashtable |
Aliases: | Tags |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-TemplateUri
служба хранилища URI шаблона определения SAS.
Тип: | String |
Position: | 3 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ValidityPeriod
Срок действия, который будет использоваться для установки времени истечения срока действия маркера SAS с момента создания
Тип: | Nullable<T>[TimeSpan] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VaultName
Имя хранилища. Командлет создает полное доменное имя хранилища на основе имени и выбранной среды.
Тип: | String |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
PSKeyVaultManagedStorageAccountIdentityItem
Параметры: InputObject (ByValue)
Выходные данные
PSKeyVaultManagedStorageSasDefinition