New-AzureDeployment
Crea una implementación a partir de un servicio.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.
El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Importante
Cloud Services (clásico) ahora está en desuso para los nuevos clientes y se retirará el 31 de agosto de 2024 para todos los clientes. Las nuevas implementaciones deben utilizar el nuevo modelo de implementación basado en Azure Resource Manager Azure Cloud Services (soporte extendido) .
Sintaxis
New-AzureDeployment
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Label] <String>]
[[-Name] <String>]
[-DoNotStart]
[-TreatWarningsAsError]
[-ExtensionConfiguration <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
El cmdlet New-AzureDeployment crea una implementación de Azure a partir de un servicio que consta de roles web y roles de trabajo. Este cmdlet crea una implementación basada en un archivo de paquete (.cspkg) y un archivo de configuración de servicio (.cscfg). Especifique un nombre que sea único en el entorno de implementación.
Use el cmdlet New-AzureVM para crear una implementación basada en máquinas virtuales de Azure.
Ejemplos
Ejemplo 1: Creación de una implementación
PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Label "ContosoDeployment"
Este comando crea una implementación de producción basada en un paquete denominado ContosoPackage.cspkg y una configuración denominada ContosoConfiguration.cscfg. El comando especifica una etiqueta para la implementación. No especifica un nombre. Este cmdlet crea un GUID como nombre.
Ejemplo 2: Creación de una implementación basada en una configuración de extensión
PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"
Este comando crea una implementación de producción basada en un paquete y una configuración. El comando especifica una configuración de extensión denominada ContosoExtensionConfig.cscfg. Este cmdlet crea GUID como el nombre y la etiqueta.
Parámetros
-Configuration
Especifica la ruta de acceso completa de un archivo de configuración de servicio.
Tipo: | String |
Posición: | 2 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DoNotStart
Especifica que este cmdlet no inicia la implementación.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ExtensionConfiguration
Especifica una matriz de objetos de configuración de extensión.
Tipo: | ExtensionConfigurationInput[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-InformationAction
Especifica cómo responde este cmdlet a un evento de información.
Los valores permitidos para este parámetro son los siguientes:
- Continuar
- Ignore
- Inquire
- SilentlyContinue
- Detención
- Suspender
Tipo: | ActionPreference |
Alias: | infa |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-InformationVariable
Especifica una variable de información.
Tipo: | String |
Alias: | iv |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Label
Especifica un nombre de etiqueta para la implementación. Si no especifica una etiqueta, este cmdlet usa un GUID.
Tipo: | String |
Posición: | 4 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Especifica un nombre de implementación. Si no especifica un nombre, este cmdlet usa un GUID.
Tipo: | String |
Alias: | DeploymentName |
Posición: | 5 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Package
Especifica la ruta de acceso o el URI de un archivo .cspkg en el almacenamiento dentro de la misma suscripción o proyecto.
Tipo: | String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
Tipo: | AzureSMProfile |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ServiceName
Especifica el nombre del servicio de Azure para la implementación.
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Slot
Especifica el entorno donde este cmdlet crea la implementación. Los valores válidos son: Ensayo y producción. El valor predeterminado es Production.
Tipo: | String |
Posición: | 3 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-TreatWarningsAsError
Especifica que los mensajes de advertencia son errores. Si especifica este parámetro, un mensaje de advertencia hace que se produzca un error en la implementación.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |