Compartir a través de

New-AzureServiceExtensionConfig

  • Referencia
Módulo:
Azure

Crea una configuración de extensión de servicio en la nube para una implementación.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos heredados de Azure que usan las API de Azure Service Manager (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 powerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [[-X509Certificate] <X509Certificate2>]
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-CertificateThumbprint] <String>
   [[-ThumbprintAlgorithm] <String>]
   [-ExtensionName] <String>
   [-ProviderNamespace] <String>
   [-PublicConfiguration] <String>
   [-PrivateConfiguration] <String>
   [-Version] <String>
   [[-ExtensionId] <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
New-AzureServiceExtensionConfig
   [[-Role] <String[]>]
   [-ExtensionId] <String>
   [-ExtensionState] <String>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet New-AzureServiceExtensionConfig crea una configuración de extensión de servicio en la nube para una implementación.

Ejemplos

Ejemplo 1: Crear una configuración de extensión

PS C:\> New-AzureServiceExtensionConfig -ExtensionName 'RDP' -Version '1.0' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

Este comando especifica una configuración de extensión.

Ejemplo 2: Creación de una configuración de extensión para un rol

PS C:\> New-AzureServiceExtensionConfig -Role WebRole1 -ExtensionName 'RDP' -ProviderNamespace Microsoft.Windows.Azure.Extensions -PublicConfiguration $p1 -PrivateConfiguration $p2;

Este comando especifica una configuración de extensión para el rol WebRole1.

Parámetros

-CertificateThumbprint

Especifica una huella digital de certificado que se va a usar para cifrar la configuración privada. Este certificado ya debe existir en el almacén de certificados. Si no especifica un certificado, este cmdlet crea un certificado.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ExtensionId

Especifica el nombre de la extensión.

Tipo:String
Posición:8
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ExtensionName

Especifica el nombre de la extensión.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ExtensionState

Especifica el estado de la extensión. Los valores permitidos para este parámetro son los siguientes:

  • Habilitar
  • Disable
  • Desinstalar
Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
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
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Stop
  • 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

-PrivateConfiguration

Especifica el texto de configuración privado.

Tipo:String
Posición:6
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-ProviderNamespace

Especifica el espacio de nombres del proveedor de la extensión.

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PublicConfiguration

Especifica el texto de configuración pública.

Tipo:String
Posición:5
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Role

Especifica una matriz opcional de roles para la que especificar la configuración de Escritorio remoto. Si no se especifica la configuración de Escritorio remoto se aplica como configuración predeterminada para todos los roles.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ThumbprintAlgorithm

Especifica un algoritmo hash de huella digital que se usa con la huella digital para identificar el certificado. Este parámetro es opcional y el valor predeterminado es sha1.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Version

Especifica la versión de la extensión.

Tipo:String
Posición:7
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-X509Certificate

Especifica un certificado x509 que, cuando se especifique, se cargará automáticamente en el servicio en la nube y se usará para cifrar la configuración privada de la extensión.

Tipo:X509Certificate2
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False