Add-AzKeyVaultManagedStorageAccount

Модуль:

Az.KeyVault Module

Добавляет существующую учетную запись служба хранилища Azure в указанный key vault для управления ключами службой Key Vault.

Синтаксис

Default (По умолчанию)

Add-AzKeyVaultManagedStorageAccount
    [-VaultName] <String>
    [-AccountName] <String>
    [-AccountResourceId] <String>
    [-ActiveKeyName] <String>
    [-DisableAutoRegenerateKey]
    [-RegenerationPeriod <TimeSpan>]
    [-Disable]
    [-Tag <Hashtable>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Настраивает существующую учетную запись служба хранилища Azure с Key Vault для управления ключами учетной записи хранения Key Vault. Учетная запись хранения уже должна существовать. Ключи хранилища никогда не предоставляются вызывающей службе. Key Vault автоматически повторно создает и переключает активный ключ на основе периода восстановления. Общие сведения об этой функции см. в статье Azure Key Vault управляемой учетной записи хранения — PowerShell.

Примеры

Пример 1. Настройка учетной записи служба хранилища Azure с Key Vault для управления ключами

$storage = Get-AzStorageAccount -ResourceGroupName "mystorageResourceGroup" -StorageAccountName "mystorage"
$servicePrincipal = Get-AzADServicePrincipal -ServicePrincipalName cfa8b339-82a2-471a-a3c9-0fc0be7a4093
New-AzRoleAssignment -ObjectId $servicePrincipal.Id -RoleDefinitionName 'Storage Account Key Operator Service Role' -Scope $storage.Id
$userPrincipalId = $(Get-AzADUser -SearchString "developer@contoso.com").Id
Set-AzKeyVaultAccessPolicy -VaultName $keyVaultName -ObjectId $userPrincipalId -PermissionsToStorage get, set
$regenerationPeriod = [System.Timespan]::FromDays(90)
Add-AzKeyVaultManagedStorageAccount -VaultName 'myvault' -AccountName 'mystorageaccount' -AccountResourceId '/subscriptions/<subscription id>/resourceGroups/myresourcegroup/providers/Microsoft.Storage/storageAccounts/mystorageaccount' -ActiveKeyName 'key1' -RegenerationPeriod $regenerationPeriod

Id                  : https://myvault.vault.azure.net:443/storage/mystorageaccount
Vault Name          : myvault
AccountName         : mystorageaccount
Account Resource Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/myrg/providers/Microsoft.St
                      orage/storageAccounts/mystorageaccount
Active Key Name     : key1
Auto Regenerate Key : True
Regeneration Period : 90.00:00:00
Enabled             : True
Created             : 5/21/2018 11:55:58 PM
Updated             : 5/21/2018 11:55:58 PM
Tags                :

Задает учетную запись хранения с Key Vault для управления ключами Key Vault. Активный набор ключей — key1. Этот ключ будет использоваться для создания маркеров SAS. Key Vault повторно создадут ключ key2 после периода восстановления с момента выполнения этой команды и задайте его в качестве активного ключа. Этот процесс автоматического восстановления будет продолжаться между key1 и key2 с разрывом в 90 дней.

Пример 2. Настройка классической учетной записи служба хранилища Azure с помощью Key Vault управления ключами

$regenerationPeriod = [System.Timespan]::FromDays(90)
Add-AzKeyVaultManagedStorageAccount -VaultName 'myvault' -AccountName 'mystorageaccount' -AccountResourceId '/subscriptions/<subscription id>/resourceGroups/myresourcegroup/providers/Microsoft.ClassicStorage/storageAccounts/mystorageaccount' -ActiveKeyName 'Primary' -RegenerationPeriod $regenerationPeriod

Id                  : https://myvault.vault.azure.net:443/storage/mystorageaccount
Vault Name          : myvault
AccountName         : mystorageaccount
Account Resource Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/myvault/providers/Microsoft.Cl
                      assicStorage/storageAccounts/mystorageaccount
Active Key Name     : Primary
Auto Regenerate Key : True
Regeneration Period : 90.00:00:00
Enabled             : True
Created             : 5/21/2018 11:55:58 PM
Updated             : 5/21/2018 11:55:58 PM
Tags                :

Задает классическую учетную запись хранения с Key Vault для управления ключами Key Vault. Активный набор ключей — primary. Этот ключ будет использоваться для создания маркеров SAS. Key Vault повторно создадут ключ "Вторичный" после периода восстановления с момента выполнения этой команды и задайте его в качестве активного ключа. Этот процесс автоматического восстановления будет продолжаться между "Primary" и "Secondary" с разрывом в 90 дней.

Параметры

-AccountName

Key Vault имя управляемой учетной записи хранения. Командлет создает полное доменное имя управляемой учетной записи хранения из имени хранилища, выбранной среды и имени учетной записи хранения.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Имя учетной записи хранения, Name

Наборы параметров

(All)

Position:	1
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-AccountResourceId

Azure идентификатор ресурса учетной записи хранения.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	StorageAccountResourceId

Наборы параметров

(All)

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ActiveKeyName

Имя ключа учетной записи хранения, который должен использоваться для создания маркеров sas.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	3
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметров

Тип:	IAzureContextContainer
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Disable

Отключает использование ключа управляемой учетной записи хранения для создания маркеров SAS.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DisableAutoRegenerateKey

Автоматическое повторное создание ключа. Если значение true, то неактивный ключ управляемой учетной записи хранения автоматически повторно создается и становится новым активным ключом после периода восстановления. Если значение false, ключи управляемой учетной записи хранения не создаются автоматически.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-RegenerationPeriod

Период восстановления. Если включен автоматический повторное создание ключа, это значение указывает интервал времени, после которого неактивные типы ключей управляемой учетной записи хранения автоматически повторно созданы и становятся новым активным ключом.

Свойства параметров

Тип:	Nullable<T>[TimeSpan]
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}

Свойства параметров

Тип:	Hashtable
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Метки

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-VaultName

Имя хранилища. Командлет создает полное доменное имя хранилища на основе имени и выбранной среды.

Свойства параметров

Тип:	String
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:	SwitchParameter
Значение по умолчанию:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	Wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

Nullable<T>

Hashtable

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

PSKeyVaultManagedStorageAccount

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

• Az.KeyVault