Set-AzKeyVaultManagedStorageSasDefinition

Módulo:

Az.KeyVault

Establece una definición de firma de acceso compartido (SAS) con Key Vault para una cuenta de Azure Storage administrada de Key Vault determinada.

Syntax

Set-AzKeyVaultManagedStorageSasDefinition
   [-VaultName] <String>
   [-AccountName] <String>
   [-Name] <String>
   [-TemplateUri] <String>
   [-SasType] <String>
   [-Disable]
   [-Tag <Hashtable>]
   -ValidityPeriod <TimeSpan>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzKeyVaultManagedStorageSasDefinition
   [-InputObject] <PSKeyVaultManagedStorageAccountIdentityItem>
   [-Name] <String>
   [-TemplateUri] <String>
   [-SasType] <String>
   [-Disable]
   [-Tag <Hashtable>]
   -ValidityPeriod <TimeSpan>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Establece una definición de firma de acceso compartido (SAS) con una cuenta de Azure Storage administrada de Key Vault determinada. Esto también establece un secreto que se puede usar para obtener el token de SAS según esta definición de SAS. El token de SAS se genera mediante estos parámetros y la clave activa de la cuenta de Azure Storage administrada de Key Vault.

Ejemplos

Ejemplo 1: Establecimiento de una definición de SAS de tipo de cuenta y obtención de un token de SAS actual basado en él

$sa = Get-AzStorageAccount -Name mysa -ResourceGroupName myrg
$kv = Get-AzKeyVault -VaultName mykv
Add-AzKeyVaultManagedStorageAccount -VaultName $kv.VaultName -AccountName $sa.StorageAccountName -AccountResourceId $sa.Id -ActiveKeyName key1 -RegenerationPeriod ([System.Timespan]::FromDays(180))
$sctx = New-AzStorageContext -StorageAccountName $sa.StorageAccountName -Protocol Https -StorageAccountKey Key1
$start = [System.DateTime]::Now.AddDays(-1)
$end = [System.DateTime]::Now.AddMonths(1)
$at = "sv=2018-03-28&ss=bfqt&srt=sco&sp=rw&spr=https"
$sas = Set-AzKeyVaultManagedStorageSasDefinition -AccountName $sa.StorageAccountName -VaultName $kv.VaultName -Name accountsas -TemplateUri $at -SasType 'account' -ValidityPeriod ([System.Timespan]::FromDays(30))
Get-AzKeyVaultSecret -VaultName $kv.VaultName -Name $sas.Sid.Substring($sas.Sid.LastIndexOf('/')+1)

Establece una definición de SAS de cuenta "accountsas" en una cuenta de almacenamiento administrada por KeyVault "mysa" en el almacén "mykv". En concreto, la secuencia anterior realiza lo siguiente:

• obtiene una cuenta de almacenamiento (preexistente)
• obtiene un almacén de claves (preexistente)
• agrega una cuenta de almacenamiento administrada por KeyVault al almacén, estableciendo Key1 como clave activa y con un período de regeneración de 180 días.
• establece un contexto de almacenamiento para la cuenta de almacenamiento especificada, con Key1
• crea un token de SAS de cuenta para los servicios Blob, File, Table y Queue, para los tipos de recursos Service, Container y Object, con todos los permisos, a través de https y con las fechas de inicio y finalización especificadas.
• establece una definición de SAS de almacenamiento administrada por KeyVault en el almacén, con el URI de plantilla como token de SAS creado anteriormente, del tipo saS "account" y válido durante 30 días.
• recupera el token de acceso real del secreto de KeyVault correspondiente a la definición de SAS.

Parámetros

-AccountName

Nombre de la cuenta de almacenamiento administrada de Key Vault. El cmdlet construye el FQDN de un nombre de cuenta de almacenamiento administrado a partir del nombre del almacén, el entorno seleccionado actualmente y el nombre de la cuenta de almacenamiento administrada.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Disable

Deshabilita el uso de la definición de sas para la generación de tokens sas.

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

-InputObject

Objeto ManagedStorageAccount.

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

-Name

Nombre de definición de sas de almacenamiento. El cmdlet construye el FQDN de una definición de sas de almacenamiento a partir del nombre del almacén, el entorno seleccionado actualmente, el nombre de la cuenta de almacenamiento y el nombre de definición de sas.

Type:	String
Aliases:	SasDefinitionName
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SasType

Tipo de SAS de almacenamiento.

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

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateUri

URI de plantilla de definición de SAS de almacenamiento.

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

-ValidityPeriod

Período de validez que se usará para establecer la hora de expiración del token sas desde el momento en que se genera.

Type:	Nullable<T>[TimeSpan]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-VaultName

Nombre del almacén. El cmdlet construye el FQDN de un almacén en función del nombre y del entorno seleccionado actualmente.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

PSKeyVaultManagedStorageAccountIdentityItem

Salidas

PSKeyVaultManagedStorageSasDefinition

Vínculos relacionados

• Get-AzKeyVaultManagedStorageSasDefinition
• Remove-AzKeyVaultManagedStorageSasDefinition
• Undo-AzKeyVaultManagedStorageSasDefinitionRemoval