Add-AzureProvisioningConfig

Referencia

Módulo:: Azure

Agrega la configuración de aprovisionamiento de una máquina virtual de Azure.

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

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-Windows]
   [-AdminUsername <String>]
   [-Password <String>]
   [-ResetPasswordOnFirstLogon]
   [-DisableAutomaticUpdates]
   [-NoRDPEndpoint]
   [-TimeZone <String>]
   [-Certificates <CertificateSettingList>]
   [-EnableWinRMHttp]
   [-DisableWinRMHttps]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-Linux]
   [-LinuxUser <String>]
   [-DisableSSH]
   [-NoSSHEndpoint]
   [-NoSSHPassword]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-CustomDataFile <String>]
   [-Password <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   -AdminUsername <String>
   [-WindowsDomain]
   [-Password <String>]
   [-ResetPasswordOnFirstLogon]
   [-DisableAutomaticUpdates]
   [-NoRDPEndpoint]
   [-TimeZone <String>]
   [-Certificates <CertificateSettingList>]
   -JoinDomain <String>
   -Domain <String>
   -DomainUserName <String>
   -DomainPassword <String>
   [-MachineObjectOU <String>]
   [-EnableWinRMHttp]
   [-DisableWinRMHttps]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

El cmdlet Add-AzureProvisioningConfig agrega información de configuración de aprovisionamiento a una configuración de máquina virtual de Azure. Puede usar el objeto de configuración para crear una máquina virtual.

Este cmdlet admite diferentes configuraciones de aprovisionamiento, incluidos servidores windows independientes, servidores windows unidos a un dominio de Active Directory y servidores basados en Linux.

Para crear un servidor unido a un dominio de Active Directory, especifique el nombre de dominio completo del dominio de Active Directory y las credenciales de dominio de un usuario que tenga permiso para unir la máquina virtual al dominio.

Ejemplos

Ejemplo 1: Creación de una máquina virtual independiente

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"

Este comando crea un objeto de configuración de máquina virtual mediante el cmdlet New-AzureVMConfig . El comando pasa ese objeto al cmdlet actual mediante el operador de canalización. El cmdlet actual agrega configuración de aprovisionamiento para una máquina virtual que ejecuta el sistema operativo Windows. La configuración incluye el nombre de usuario y la contraseña del administrador. El comando pasa la configuración al cmdlet New-AzureVM , que crea la máquina virtual.

Ejemplo 2: Creación de una máquina virtual unida a un dominio

PS C:\> New-AzureVMConfig -Name "DomainVM" -InstanceSize Small -ImageName "Image09" | Add-AzureProvisioningConfig -WindowsDomain -Password "password" -AdminUsername "AdminMain" -ResetPasswordOnFirstLogon -JoinDomain "contoso.com" -Domain "contoso" -DomainUserName "DomainAdminUser" -DomainPassword "DomainPassword" -MachineObjectOU 'OU=AzureVMs,DC=contoso,DC=com' | New-AzureVM -ServiceName "ContosoService"

Este comando crea un objeto de configuración de máquina virtual y, a continuación, lo pasa al cmdlet actual. El cmdlet actual agrega configuración de aprovisionamiento para que una máquina virtual se una al dominio contoso. El comando incluye el nombre de usuario y la contraseña necesarios para unir la máquina virtual al dominio. La configuración requiere que el usuario cambie la contraseña de usuario en el primer inicio de sesión. El comando crea la máquina virtual basada en el objeto de aprovisionamiento.

Ejemplo 3: Creación de una máquina virtual basada en Linux

PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"

Este comando crea un objeto de configuración de máquina virtual y, a continuación, lo pasa al cmdlet actual. El cmdlet actual agrega configuración de aprovisionamiento para una máquina virtual que ejecuta el sistema operativo Linux. La configuración incluye el nombre de usuario raíz y la contraseña. El comando crea la máquina virtual basada en el objeto de aprovisionamiento.

Ejemplo 4: Creación de una máquina virtual que incluya certificados para WinRM

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image11" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

El primer comando obtiene certificados de un almacén de certificados y, a continuación, los almacena en la variable de matriz $certs.

El segundo comando crea un objeto de configuración de máquina virtual y, a continuación, lo pasa al cmdlet actual. El cmdlet actual agrega la configuración de aprovisionamiento que incluye certificados para WinRM. El comando crea la máquina virtual basada en el objeto de aprovisionamiento.

Ejemplo 5: Creación de una máquina virtual con WinRM habilitado a través de HTTP

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

Este comando crea un objeto de configuración de máquina virtual y, a continuación, lo pasa al cmdlet actual. El cmdlet actual agrega la configuración de aprovisionamiento que tiene WinRM habilitado a través de HTTP. El comando crea la máquina virtual basada en el objeto de aprovisionamiento.

Ejemplo 6: Creación de una máquina virtual que tenga WinRM deshabilitado a través de HTTPS

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

Este comando crea un objeto de configuración de máquina virtual y, a continuación, lo pasa al cmdlet actual. El cmdlet actual agrega la configuración de aprovisionamiento que deshabilita WinRM a través de HTTPS. El comando crea la máquina virtual basada en el objeto de aprovisionamiento.

Ejemplo 7: Creación de una máquina virtual sin exportación de claves

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -X509Certificates $certs[0], $certs[1] -NoExportPrivateKey | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

El primer comando obtiene certificados de un almacén de certificados y, a continuación, los almacena en la variable de matriz $certs.

El segundo comando crea un objeto de configuración de máquina virtual y, a continuación, lo pasa al cmdlet actual. El cmdlet actual agrega configuración de aprovisionamiento para una máquina virtual que incluye certificados y no exporta claves privadas. El comando crea la máquina virtual basada en el objeto de aprovisionamiento.

Parámetros

-AdminUsername

Especifica el nombre de usuario de la cuenta de administrador que crea esta configuración en la máquina virtual.

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

-Certificates

Especifica un conjunto de certificados que esta configuración instala en la máquina virtual.

Tipo:	CertificateSettingList
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CustomDataFile

Especifica un archivo de datos para la máquina virtual. Este cmdlet codifica el contenido del archivo como Base64. El archivo debe tener menos de 64 kilobytes de longitud.

Si el sistema operativo invitado es el sistema operativo Windows, esta configuración guarda estos datos como un archivo binario denominado %SYSTEMDRIVE%\AzureData\CustomData.bin.

Si el sistema operativo invitado es Linux, esta configuración pasa los datos mediante el archivo ovf-env.xml. La configuración copia ese archivo en el directorio /var/lib/waagent. El agente también almacena los datos codificados en Base64 en /var/lib/waagent/CustomData.

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

-DisableAutomaticUpdates

Indica que esta configuración deshabilita las actualizaciones automáticas.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableGuestAgent

Indica que esta configuración deshabilita el agente invitado de infraestructura como servicio (IaaS).

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableSSH

Indica que esta configuración deshabilita SSH.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWinRMHttps

Indica que esta configuración deshabilita la administración remota de Windows (WinRM) en HTTPS. De forma predeterminada, WinRM está habilitado a través de HTTPS.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Domain

Especifica el nombre del dominio de la cuenta que tiene permiso para agregar el equipo a un dominio.

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

-DomainPassword

Especifica la contraseña de la cuenta de usuario que tiene permiso para agregar el equipo a un dominio.

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

-DomainUserName

Especifica el nombre de la cuenta de usuario que tiene permiso para agregar el equipo a un dominio.

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

-EnableWinRMHttp

Indica que esta configuración habilita WinRM a través de HTTP.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
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

-JoinDomain

Especifica el nombre de dominio completo (FQDN) del dominio que se va a unir.

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

-Linux

Indica que esta configuración crea una configuración de Linux.

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

-LinuxUser

Especifica el nombre de usuario de la cuenta administrativa de Linux que crea esta configuración en la máquina virtual.

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

-MachineObjectOU

Especifica el nombre completo de la unidad organizativa (OU) en la que la configuración crea la cuenta de equipo.

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

-NoExportPrivateKey

Indica que esta configuración no carga la clave privada.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoRDPEndpoint

Indica que esta configuración crea una máquina virtual sin un punto de conexión de Escritorio remoto.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoSSHEndpoint

Indica que esta configuración crea una máquina virtual sin un punto de conexión SSH.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoSSHPassword

Indica que esta configuración crea una máquina virtual sin una contraseña SSH.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NoWinRMEndpoint

Indica que esta configuración no agrega un punto de conexión winRM para la máquina virtual.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Password

Especifica la contraseña de la cuenta de administrador.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
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

-ResetPasswordOnFirstLogon

Indica que la máquina virtual requiere que el usuario cambie la contraseña en el primer inicio de sesión.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SSHKeyPairs

Especifica pares de claves SSH.

Tipo:	SSHKeyPairList
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SSHPublicKeys

Especifica claves públicas SSH.

Tipo:	SSHPublicKeyList
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TimeZone

Especifica la zona horaria de la máquina virtual, por ejemplo, hora estándar del Pacífico o hora estándar de Canadá Central.

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

-VM

Especifica un objeto de máquina virtual.

Tipo:	IPersistentVM
Alias:	InputObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Windows

Indica que esta configuración crea una máquina virtual independiente que ejecuta el sistema operativo Windows.

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

-WindowsDomain

Indica que esta configuración crea un servidor de Windows que está unido a un dominio de Active Directory.

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

-WinRMCertificate

Especifica un certificado que esta configuración asocia a un punto de conexión de WinRM.

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

-X509Certificates

Especifica una matriz de certificados X509 que se implementan en un servicio hospedado.

Tipo:	X509Certificate2[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Compartir a través de