Compartir a través de


Administrar Azure Redis con Azure PowerShell

En este artículo se muestra cómo crear, administrar y eliminar las instancias de Azure Redis mediante Azure PowerShell.

Prerrequisitos

  • Asegúrese de que ha iniciado sesión en Azure con la suscripción en la que desea crear la memoria caché. Para usar una suscripción diferente a la que ha iniciado sesión, ejecute Select-AzSubscription -SubscriptionName <SubscriptionName>.

Nota:

Azure Managed Redis usa los comandos Az.RedisEnterpriseCache de Azure PowerShell.

Azure Cache for Redis usa los comandos para los Az.RedisEnterpriseCache niveles Enterprise y los comandos Az.RedisCache de Azure PowerShell para los niveles Básico, Estándar y Premium. Puede usar los siguientes scripts para crear y administrar Azure Managed Redis o Azure Cache for Redis Enterprise. Para Azure Cache for Redis Basic, Standard y Premium, use los scripts de Azure Cache for Redis .

Creación de una caché de Azure Managed Redis

Cree nuevas instancias de Redis administradas de Azure mediante el cmdlet New-AzRedisEnterpriseCache . ResourceGroupName, Name, Locationy Sku son parámetros obligatorios. Los demás parámetros son opcionales y tienen valores predeterminados.

La autenticación de Microsoft Entra está habilitada de forma predeterminada para todas las memorias caché nuevas y se recomienda para la seguridad.

Importante

Use Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché si es posible. La autorización con el identificador y la identidad administrada de Microsoft Entra proporcionan una mejor seguridad y es más fácil de usar que la autorización de clave de acceso compartido. Para más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra para la autenticación de caché con Azure Managed Redis.

Para ver todos los parámetros y propiedades de PowerShell de Azure Managed Redis para New-AzRedisEnterpriseCache, consulte New-AzRedisEnterpriseCache. Para generar una lista de parámetros disponibles y sus descripciones, ejecute el siguiente comando.

Get-Help New-AzRedisEnterpriseCache -detailed

Nota:

La primera vez que cree una caché de Azure Managed Redis en una suscripción, Azure registrará automáticamente el espacio de nombres Microsoft.Cache. Si se le solicita, puede usar el comando de Azure PowerShell Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" para registrar el espacio de nombres.

El siguiente comando de ejemplo crea una instancia de Redis administrada de Azure con el nombre, la ubicación, el grupo de recursos y la SKU especificados mediante parámetros predeterminados. La instancia tiene un tamaño de 1 GB con el puerto no SSL deshabilitado.

New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Balanced_B1

Creación y configuración de bases de datos

Puede usar el cmdlet New-AzRedisEnterpriseCacheDatabase para crear y configurar bases de datos para la caché de Azure Managed Redis. Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisEnterpriseCacheDatabase, ejecute el siguiente comando.

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

Si no configura bases de datos durante la creación de la caché, New-AzRedisEnterpriseCache crea una base de datos en la memoria caché denominada default de forma predeterminada y todos los datos de caché entran en esta DB 0 base de datos.

Actualizar un Azure Managed Redis cache

Puede actualizar instancias de Azure Managed Redis mediante el cmdlet Update-AzRedisEnterpriseCache . Para ver una lista de parámetros disponibles y sus descripciones para Update-AzRedisEnterpriseCache, ejecute el siguiente comando.

Get-Help Update-AzRedisEnterpriseCache -detailed

Puede usar el Update-AzRedisEnterpriseCache cmdlet para actualizar propiedades como Sku, Tagy MinimumTlsVersion. El comando siguiente actualiza la versión mínima de Seguridad de la capa de transporte (TLS) y agrega una etiqueta a la caché de Azure Managed Redis denominada myCache.

Update-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -MinimumTlsVersion "1.2" -Tag @{"tag1" = "value1"}

Obtener información sobre una caché de Azure Managed Redis

Puede recuperar información sobre una caché utilizando el cmdlet Get-AzRedisEnterpriseCache. Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisEnterpriseCache, ejecute el siguiente comando.

Get-Help Get-AzRedisEnterpriseCache -detailed

Para devolver información sobre todas las cachés de la suscripción actual, ejecute Get-AzRedisEnterpriseCache sin ningún parámetro.

Get-AzRedisEnterpriseCache

Para devolver información sobre todas las cachés de un grupo de recursos específico, ejecute Get-AzRedisEnterpriseCache con el parámetro ResourceGroupName.

Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

Para devolver información sobre una caché específica, ejecute Get-AzRedisEnterpriseCache con Name y ResourceGroupName de la caché.

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Recuperar las claves de acceso de una caché de Azure Managed Redis

Para recuperar las claves de acceso de la memoria caché, use el cmdlet Get-AzRedisEnterpriseCacheKey . Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisEnterpriseCacheKey, ejecute el siguiente comando.

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

Para recuperar las claves de la caché, llame al cmdlet Get-AzRedisEnterpriseCacheKey con el Name y el ResourceGroupName de la caché.

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

Importante

La ListKeys operación solo funciona cuando las claves de acceso están habilitadas para la memoria caché. La salida de este comando podría poner en peligro la seguridad mostrando secretos y puede desencadenar una advertencia de información confidencial.

Regeneración de claves de acceso para una caché de Azure Managed Redis

Para regenerar las claves de acceso de su caché, puede utilizar el cmdlet New-AzRedisEnterpriseCacheKey. Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisEnterpriseCacheKey, ejecute el siguiente comando.

Get-Help New-AzRedisEnterpriseCacheKey -detailed

Para volver a generar la clave principal o secundaria de la memoria caché, llame al New-AzRedisEnterpriseCacheKey cmdlet con la memoria caché Name y ResourceGroupNamey especifique Primary o Secondary para el KeyType parámetro . En el ejemplo siguiente se vuelve a generar la clave de acceso secundaria para una memoria caché.

New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

Eliminar una caché de Azure Managed Redis

Para eliminar una instancia de Azure Managed Redis Cache, use el cmdlet Remove-AzRedisEnterpriseCache . Para ver una lista de parámetros disponibles y sus descripciones para Remove-AzRedisEnterpriseCache, ejecute el siguiente comando.

Get-Help Remove-AzRedisEnterpriseCache -detailed

En el ejemplo siguiente se quita la memoria caché denominada myCache.

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

Importación de datos de Azure Managed Redis Cache

Puede importar datos a una instancia de Azure Managed Redis utilizando el cmdlet Import-AzRedisEnterpriseCache. Para ver una lista de parámetros disponibles y sus descripciones para Import-AzRedisEnterpriseCache, ejecute el siguiente comando.

Get-Help Import-AzRedisEnterpriseCache -detailed

Se requieren la memoria caché Name, ResourceGroupName y el SasUri del blob que se va a importar. El siguiente comando importa datos del blob especificado por el URI de SAS.

Import-AzRedisEnterpriseCache -ClusterName "myCache" -ResourceGroupName "myGroup" -SasUri @("<sas-uri>")

Exportación de datos de Azure Managed Redis Cache

Puede exportar datos de una instancia de Azure Managed Redis utilizando el cmdlet Export-AzRedisEnterpriseCache. Para ver una lista de parámetros disponibles y sus descripciones para Export-AzRedisEnterpriseCache, ejecute el siguiente comando.

Get-Help Export-AzRedisEnterpriseCache -detailed

Se requieren la memoria caché Name, ResourceGroupName y el SasUri del contenedor que se va a exportar. El siguiente comando de ejemplo exporta datos del contenedor especificado por el URI de SAS.

Export-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -SasUri "https://mystorageaccount.blob.core.windows.net/mycontainer?sp=signedPermissions&se=signedExpiry&sv=signedVersion&sr=signedResource&sig=signature;mystoragekey"

Importante

Azure Cache for Redis usa los comandos Az.RedisCache de Azure PowerShell para los niveles Básico, Estándar y Premium, y los comandos Az.RedisEnterpriseCache de Azure PowerShell para los niveles Enterprise.

Puede usar los siguientes scripts para crear y administrar Azure Cache for Redis Basic, Standard y Premium. Para Azure Cache for Redis Enterprise o Azure Managed Redis, use los comandos de Azure Managed Redis .

Propiedades y parámetros de PowerShell de Azure Cache for Redis

En las tablas siguientes se muestran las propiedades y descripciones de Azure PowerShell para los parámetros comunes de Azure Cache for Redis. Para ver todos los parámetros y propiedades de Azure PowerShell para Az.RedisCache, consulte AzRedisCache.

Parámetro Descripción Predeterminado
Nombre Nombre de la caché.
Ubicación Ubicación de la memoria caché.
NombreDelGrupoDeRecursos Nombre del grupo de recursos en el que se va a crear la memoria caché.
Tamaño El tamaño de la memoria caché. Los valores válidos son: P1, P2, P3, P4, P5, C0, C1, C2, C3, C4, C5, C6, 250 MB, 1 GB, 2,5 GB, 6 GB, 13 GB, 26 GB, 53 GB. 1 GB
ShardCount El número de particiones para crear durante la creación de una memoria caché premium con clúster habilitado. Los valores válidos son: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10.
Código de referencia SKU de la caché. Los valores válidos son: Básico, Estándar, Premium. Estándar
RedisConfiguration Opciones de configuración de Redis. Para ver detalles sobre cada opción de configuración, consulte la siguiente tabla Propiedades de RedisConfiguration .
EnableNonSslPort Indica si el puerto que no es SSL está habilitado. Falso
MaxMemoryPolicy Este parámetro está en desuso. En su lugar, use RedisConfiguration.
StaticIP Al hospedar la memoria caché en una red virtual, se asigna una dirección IP única en la subred para la memoria caché. Si no se ofrece, elija una para usted en la subred.
Subred Al hospedar la memoria caché en una red virtual, el nombre de la subred en la que se va a implementar la memoria caché.
VirtualNetwork Al hospedar la memoria caché en una red virtual, el identificador de recurso de la red virtual en la que se va a implementar la memoria caché.
Tipo de Clave La clave de acceso que hay que regenerar cuando se renueven las claves de acceso. Los valores válidos son: Principal, Secundario.

Propiedades del parámetro RedisConfiguration

Propiedad Descripción Planes de tarifa
rdb-backup-enabled Si Persistencia de los datos en Redis está habilitado Solo Premium
rdb-storage-connection-string La cadena de conexión a la cuenta de almacenamiento para Persistencia de los datos en Redis. Solo Premium
rdb-backup-frequency La frecuencia de copia de seguridad de Persistencia de los datos en Redis. Solo Premium
maxmemory-reserved Memoria reservada para procesos que no son de caché. Estándar y Premium
política de maxmemory [Directiva de expulsión]/azure-cache-for-redis/cache-configure.md#memory-policies) para la caché. Todos los planes de tarifa
notify-keyspace-events [Notificaciones de espacio de claves]/azure-cache-for-redis/cache-configure.md#keyspace-notifications-advanced-settings). Estándar y Premium
hash-max-ziplist-entries Optimización de memoria para tipos de datos agregados pequeños. Estándar y Premium
hash-max-ziplist-value Optimización de memoria para tipos de datos agregados pequeños. Estándar y Premium
set-max-intset-entries Optimización de memoria para tipos de datos agregados pequeños. Estándar y Premium
zset-max-ziplist-entries Optimización de memoria para tipos de datos agregados pequeños. Estándar y Premium
zset-max-ziplist-value Optimización de memoria para tipos de datos agregados pequeños. Estándar y Premium
Bases Número de bases de datos. Esta propiedad solo se puede configurar en la creación de la memoria caché. Estándar y Premium

Creación de una caché de Azure Cache for Redis

Las instancias de Azure Cache for Redis se crean mediante el cmdlet New-AzRedisCache . ResourceGroupName, Namey Location son parámetros obligatorios. Los demás parámetros son opcionales y tienen valores predeterminados.

Importante

Se recomienda la autenticación de Microsoft Entra para la seguridad. Puede habilitar la autenticación de Microsoft Entra durante o después de la creación de la memoria caché.

Use Microsoft Entra ID con identidades administradas para autorizar solicitudes en la memoria caché si es posible. La autorización con el identificador y la identidad administrada de Microsoft Entra proporcionan una mejor seguridad y es más fácil de usar que la autorización de clave de acceso compartido. Para más información sobre el uso de identidades administradas con la memoria caché, consulte Uso de Microsoft Entra ID para la autenticación de caché.

Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisCache, ejecute el siguiente comando:

Get-Help New-AzRedisCache -detailed>

Nota:

La primera vez que cree una caché de Azure Cache for Redis en una suscripción, Azure registrará automáticamente el espacio de nombres Microsoft.Cache. Si se le solicita, puede usar el comando de Azure PowerShell Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" para registrar el espacio de nombres.

El siguiente comando de ejemplo crea una instancia de Azure Cache for Redis con el nombre, la ubicación y el grupo de recursos especificados mediante parámetros predeterminados. La instancia es una caché estándar de 1 GB con el puerto no SSL deshabilitado.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

Para especificar valores para el RedisConfiguration parámetro, incluya los pares clave-valor entre corchetes {}. En el ejemplo siguiente se crea una caché de 1 GB con @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. Para más información, consulte Notificaciones de Keyspace (configuración avanzada) y Directivas de memoria.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

Creación de una caché Premium

Para crear una caché de nivel Premium de Azure Cache for Redis, especifique un tamaño de P1 (6-60 GB), P2 (13-130 GB), P3 (26-260 GB) o P4 (53-530 GB). Para habilitar la agrupación en clústeres, especifique un número de particiones mediante el parámetro ShardCount .

En el ejemplo siguiente se crea una caché P1 Premium con tres particiones. Una caché premium P1 tiene un tamaño de 6 GB, y con tres fragmentos, el tamaño total es de 18 GB (3 x 6 GB).

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3

Configuración de la configuración de las bases de datos

El databases valor del cmdlet New-AzRedisCache configura el número de bases de datos de la memoria caché. Solo puede configurar databases para los niveles Estándar y Premium, y solo durante la creación de caché mediante PowerShell u otros clientes de administración.

Si no especifica una databases configuración durante la creación de la caché, New-AzRedisCache crea una base de datos denominada defaulty todos los datos de caché entran en esta DB 0 base de datos. El límite de la base de datos depende del nivel de caché y el tamaño, pero la configuración predeterminada es 16.

En el ejemplo siguiente se crea una caché premium P3 (26 GB) con 48 bases de datos.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}

Para más información sobre la propiedad databases, consulte Configuración predeterminada del servidor Azure Cache for Redis.

Actualización de una caché de Azure Cache for Redis

Las instancias de Azure Cache for Redis se actualizan mediante el cmdlet Set-AzRedisCache . Para ver una lista de parámetros disponibles y sus descripciones para Set-AzRedisCache, ejecute el siguiente comando.

Get-Help Set-AzRedisCache -detailed

Puede usar el Set-AzRedisCache cmdlet para actualizar propiedades como Size, Sku, EnableNonSslPorty los RedisConfiguration valores. El siguiente comando de ejemplo actualiza el maxmemory-policy para la instancia de Azure Cache for Redis llamada myCache.

Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

Escalado de una caché de Azure Cache for Redis

Puede usar Set-AzRedisCache para escalar una instancia de Azure Cache for Redis al modificar las propiedades Size, Sku o ShardCount.

Nota:

El escalado de una caché mediante PowerShell tiene los mismos límites y directrices que el escalado de una caché mediante Azure Portal. Puede escalar a un plan de tarifa diferente con las siguientes restricciones:

  • No se puede escalar desde un plan de tarifa superior a un plan de tarifa inferior, como desde una caché Premium a una caché estándar o básica, o desde una memoria caché estándar a una caché básica.
  • Puede escalar de una caché básica a una caché estándar, pero no puede cambiar el tamaño al mismo tiempo. Si necesita un tamaño diferente, puede realizar otra operación de escalado al tamaño deseado.
  • No se puede escalar desde una caché básica directamente a una caché Premium. Debe escalar de Básico a Estándar en una operación de escalado y, a continuación, de Estándar a Premium en otra operación.
  • No se puede escalar desde un tamaño mayor hasta el tamaño C0 (250 MB).

Para obtener más información, consulte Cómo escalar Azure Cache for Redis.

En el ejemplo siguiente se muestra cómo escalar una caché denominada myCache a un tamaño de 2,5 GB. Este comando funciona para una caché básica o estándar.

Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB

Después de emitir este comando, se devuelve el estado de la memoria caché, similar a llamar a Get-AzRedisCache. ProvisioningState se establece en Scaling.

Cuando se complete la operación de escalado, ProvisioningState cambia a Succeeded. Si necesita realizar otra operación de escalado, como cambiar el tamaño después de cambiar de Básico a Estándar, debe esperar hasta que se complete la operación anterior. De lo contrario, recibirá un error similar al siguiente mensaje.

Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.

Obtener información acerca de una caché Azure Cache for Redis

Puede recuperar información sobre una caché con el cmdlet Get-AzRedisCache. Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisCache, ejecute el siguiente comando.

Get-Help Get-AzRedisCache -detailed

Para devolver información sobre todas las cachés de la suscripción actual, ejecute Get-AzRedisCache sin ningún parámetro.

Get-AzRedisCache

Para devolver información sobre todas las cachés de un grupo de recursos específico, ejecute Get-AzRedisCache con el parámetro ResourceGroupName.

Get-AzRedisCache -ResourceGroupName myGroup

Para devolver información sobre una caché específica, ejecute Get-AzRedisCache con la memoria caché Name y ResourceGroupName.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

Recuperación de las claves de acceso de una caché de Azure Cache for Redis

Para recuperar las claves de acceso de la caché, puede usar el cmdlet Get-AzRedisCacheKey. Para ver una lista de parámetros disponibles y sus descripciones para Get-AzRedisCacheKey, ejecute el siguiente comando.

Get-Help Get-AzRedisCacheKey -detailed

Para recuperar las claves de la memoria caché, ejecute el cmdlet Get-AzRedisCacheKey con la memoria caché Name y ResourceGroupName.

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

Importante

La ListKeys operación solo funciona cuando las claves de acceso están habilitadas para la memoria caché. La salida de este comando podría poner en peligro la seguridad mostrando secretos y puede desencadenar una advertencia de información confidencial.

Regeneración de claves de acceso para una caché de Azure Cache for Redis

Para recuperar las claves de acceso de la caché, puede usar el cmdlet Get-AzRedisCacheKey. Para ver una lista de parámetros disponibles y sus descripciones para New-AzRedisCacheKey, ejecute el siguiente comando.

Get-Help New-AzRedisCacheKey -detailed

Para volver a generar la clave principal o secundaria de la memoria caché, llame al New-AzRedisCacheKey cmdlet con la memoria caché Name y ResourceGroupNamey especifique Primary o Secondary para el KeyType parámetro . En el ejemplo siguiente se vuelve a generar la clave de acceso secundaria para una memoria caché.

New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

Eliminación de una caché de Azure Cache for Redis

Para eliminar una caché de Azure Cache for Redis, use el cmdlet Remove-AzRedisCache . Para ver una lista de parámetros disponibles y sus descripciones para Remove-AzRedisCache, ejecute el siguiente comando.

Get-Help Remove-AzRedisCache -detailed

En el ejemplo siguiente se quita la memoria caché denominada myCache.

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

Importación de datos en una caché de Azure Cache for Redis

Puede importar datos a una instancia de Azure Cache for Redis mediante el cmdlet Import-AzRedisCache.

Importante

La importación solo está disponible para las memorias caché de nivel Premium . Para más información, consulte Importación y exportación de datos en Azure Cache for Redis.

Para ver una lista de parámetros disponibles y sus descripciones para Import-AzRedisCache, ejecute el siguiente comando.

Get-Help Import-AzRedisCache -detailed

El comando siguiente importa datos del blob especificado por el Files parámetro en Azure Cache for Redis.

Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=signedVersion&sr=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions") -Force

Exportación de datos de una caché de Azure Cache for Redis

Puede exportar datos a una instancia de Azure Cache for Redis mediante el cmdlet Export-AzRedisCache.

Importante

La exportación solo está disponible para las memorias caché de nivel Premium . Para más información, consulte Importación y exportación de datos en Azure Cache for Redis.

Para ver una lista de parámetros disponibles y sus descripciones para Export-AzRedisCache, ejecute el siguiente comando.

Get-Help Export-AzRedisCache -detailed

El comando siguiente exporta datos desde una instancia de Azure Cache for Redis al contenedor especificado por el Container parámetro .

Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix" -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions"

Reinicio de una caché de Azure Cache for Redis

Puede reiniciar la instancia de Azure Cache for Redis mediante el cmdlet Reset-AzRedisCache.

Importante

El reinicio solo está disponible para las cachés de Azure Cache for Redis de nivel Básico, Estándar y Premium . Para obtener más información, consulte Administración de caché: reinicio.

Para ver una lista de parámetros disponibles y sus descripciones para Reset-AzRedisCache, ejecute el siguiente comando.

Get-Help Reset-AzRedisCache -detailed

El siguiente comando reinicia ambos nodos de la memoria caché especificada.

Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes" -Force

Comandos generales de Azure PowerShell

Ejecute estos comandos en el entorno de comandos de Azure PowerShell.

Compruebe la versión de Azure PowerShell:

Get-Module Az | format-table version

Inicie sesión en Azure:

Connect-AzAccount

Consulte una lista de las suscripciones actuales:

Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

Especifique una suscripción de Azure que se va a usar:

Select-AzSubscription -SubscriptionName ContosoSubscription

Obtenga ayuda detallada para cualquier cmdlet:

Get-Help <cmdlet-name> -Detailed

Conexión a otras nubes

De forma predeterminada, el entorno de Azure es AzureCloud, que representa la nube global de Azure. Para conectarse a otra instancia de nube, use el comando Connect-AzAccount con el conmutador de línea de comandos -Environment o -EnvironmentName con el nombre de entorno o el entorno que quiera.

Para ver la lista de entornos disponibles, ejecute Get-AzEnvironment.

Azure Government Cloud (Nube de Azure Government)

Para conectarse a la nube de Azure Government, utilice
Connect-AzAccount -EnvironmentName AzureUSGovernment
O bien,
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

Para crear una caché en la nube de Azure Government, use las ubicaciones USGov Virginia o USGov Iowa.

Para más información acerca de la nube de Azure Government, consulte Microsoft Azure Government y la Guía para desarrolladores de Microsoft Azure Government.

Azure operado por 21Vianet

Para conectarse a la nube de Azure operada por 21Vianet (China), use
Connect-AzAccount -EnvironmentName AzureChinaCloud
O bien,
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

Para crear una memoria caché en la nube de Azure operada por 21Vianet, use las ubicaciones China East o China North.

Microsoft Azure Alemania

Para conectarse a la nube de Microsoft Azure Alemania, utilice
Connect-AzAccount -EnvironmentName AzureGermanCloud
O bien,
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

Para crear una caché en Microsoft Azure en Alemania, use las ubicaciones Germany Central o Germany Northeast.

Para obtener más información acerca de Microsoft Azure Alemania, consulte Microsoft Azure Germany.