Add-AzureProvisioningConfig

  • Référence
Module:
Azure

Ajoute la configuration d’approvisionnement pour une machine virtuelle Azure.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

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

L’applet de commande Add-AzureProvisioningConfig ajoute des informations de configuration de provisionnement à une configuration de machine virtuelle Azure. Vous pouvez utiliser l’objet de configuration pour créer une machine virtuelle.

Cette applet de commande prend en charge différentes configurations d’approvisionnement, notamment les serveurs Windows autonomes, les serveurs Windows joints à un domaine Active Directory et les serveurs Linux.

Pour créer un serveur joint à un domaine Active Directory, spécifiez le nom de domaine complet du domaine Active Directory et les informations d’identification de domaine d’un utilisateur autorisé à joindre la machine virtuelle au domaine.

Exemples

Exemple 1 : Créer une machine virtuelle autonome

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

Cette commande crée un objet de configuration de machine virtuelle à l’aide de l’applet de commande New-AzureVMConfig . La commande transmet cet objet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle ajoute la configuration d’approvisionnement pour une machine virtuelle qui exécute le système d’exploitation Windows. La configuration inclut le nom d’utilisateur et le mot de passe de l’administrateur. La commande transmet la configuration à l’applet de commande New-AzureVM , qui crée la machine virtuelle.

Exemple 2 : Créer une machine virtuelle jointe à un domaine

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"

Cette commande crée un objet de configuration de machine virtuelle, puis la transmet à l’applet de commande actuelle. L’applet de commande actuelle ajoute la configuration d’approvisionnement d’une machine virtuelle à joindre au domaine contoso. La commande inclut le nom d’utilisateur et le mot de passe nécessaires pour joindre la machine virtuelle au domaine. La configuration nécessite que l’utilisateur modifie le mot de passe de l’utilisateur lors de la première ouverture de session. La commande crée la machine virtuelle en fonction de l’objet d’approvisionnement.

Exemple 3 : Créer une machine virtuelle Linux

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

Cette commande crée un objet de configuration de machine virtuelle, puis la transmet à l’applet de commande actuelle. L’applet de commande actuelle ajoute la configuration d’approvisionnement pour une machine virtuelle qui exécute le système d’exploitation Linux. La configuration inclut le nom d’utilisateur racine et le mot de passe. La commande crée la machine virtuelle en fonction de l’objet d’approvisionnement.

Exemple 4 : Créer une machine virtuelle qui inclut des certificats pour 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

La première commande obtient des certificats à partir d’un magasin de certificats, puis les stocke dans la variable de tableau $certs.

La deuxième commande crée un objet de configuration de machine virtuelle, puis le transmet à l’applet de commande actuelle. L’applet de commande actuelle ajoute la configuration d’approvisionnement qui inclut des certificats pour WinRM. La commande crée la machine virtuelle en fonction de l’objet d’approvisionnement.

Exemple 5 : Créer une machine virtuelle sur laquelle WinRM est activé sur HTTP

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

Cette commande crée un objet de configuration de machine virtuelle, puis la transmet à l’applet de commande actuelle. L’applet de commande actuelle ajoute la configuration d’approvisionnement avec WinRM activée sur HTTP. La commande crée la machine virtuelle en fonction de l’objet d’approvisionnement.

Exemple 6 : Créer une machine virtuelle avec WinRM désactivée sur HTTPS

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

Cette commande crée un objet de configuration de machine virtuelle, puis la transmet à l’applet de commande actuelle. L’applet de commande actuelle ajoute la configuration d’approvisionnement qui désactive WinRM sur HTTPS. La commande crée la machine virtuelle en fonction de l’objet d’approvisionnement.

Exemple 7 : Créer une machine virtuelle sans exportation de clé

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

La première commande obtient des certificats à partir d’un magasin de certificats, puis les stocke dans la variable de tableau $certs.

La deuxième commande crée un objet de configuration de machine virtuelle, puis le transmet à l’applet de commande actuelle. L’applet de commande actuelle ajoute la configuration d’approvisionnement pour une machine virtuelle qui inclut des certificats et n’exporte pas de clés privées. La commande crée la machine virtuelle en fonction de l’objet d’approvisionnement.

Paramètres

-AdminUsername

Spécifie le nom d’utilisateur du compte Administrateur créé par cette configuration sur la machine virtuelle.

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

-Certificates

Spécifie un ensemble de certificats que cette configuration installe sur la machine virtuelle.

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

-CustomDataFile

Spécifie un fichier de données pour la machine virtuelle. Cette applet de commande encode le contenu du fichier en base64. Le fichier doit être inférieur à 64 kilo-octets.

Si le système d’exploitation invité est le système d’exploitation Windows, cette configuration enregistre ces données sous la forme d’un fichier binaire nommé %SYSTEMDRIVE%\AzureData\CustomData.bin.

Si le système d’exploitation invité est Linux, cette configuration transmet les données à l’aide du fichier ovf-env.xml. La configuration copie ce fichier dans le répertoire /var/lib/waagent. L’agent stocke également les données encodées en Base64 dans /var/lib/waagent/CustomData.

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

-DisableAutomaticUpdates

Indique que cette configuration désactive les mises à jour automatiques.

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

-DisableGuestAgent

Indique que cette configuration désactive l’agent invité IaaS (Infrastructure as a Service).

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

-DisableSSH

Indique que cette configuration désactive SSH.

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

-DisableWinRMHttps

Indique que cette configuration désactive Windows Remote Management (WinRM) sur HTTPS. Par défaut, WinRM est activé sur HTTPS.

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

-Domain

Spécifie le nom du domaine du compte autorisé à ajouter l’ordinateur à un domaine.

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

-DomainPassword

Spécifie le mot de passe du compte d’utilisateur autorisé à ajouter l’ordinateur à un domaine.

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

-DomainUserName

Spécifie le nom du compte d’utilisateur autorisé à ajouter l’ordinateur à un domaine.

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

-EnableWinRMHttp

Indique que cette configuration active WinRM sur HTTP.

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

-InformationAction

Spécifie la façon dont cette applet de commande répond à un événement d’information.

Les valeurs valides pour ce paramètre sont :

  • Continuer
  • Ignorer
  • Renseignez-vous
  • SilentlyContinue
  • Arrêter
  • Suspendre
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Spécifie une variable d’informations.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JoinDomain

Spécifie le nom de domaine complet (FQDN) du domaine à joindre.

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

-Linux

Indique que cette configuration crée une configuration Linux.

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

-LinuxUser

Spécifie le nom d’utilisateur du compte d’administration Linux que cette configuration crée sur la machine virtuelle.

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

-MachineObjectOU

Spécifie le nom complet de l’unité d’organisation (UO) dans laquelle la configuration crée le compte d’ordinateur.

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

-NoExportPrivateKey

Indique que cette configuration ne charge pas la clé privée.

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

-NoRDPEndpoint

Indique que cette configuration crée une machine virtuelle sans point de terminaison bureau à distance.

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

-NoSSHEndpoint

Indique que cette configuration crée une machine virtuelle sans point de terminaison SSH.

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

-NoSSHPassword

Indique que cette configuration crée une machine virtuelle sans mot de passe SSH.

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

-NoWinRMEndpoint

Indique que cette configuration n’ajoute pas de point de terminaison WinRM pour la machine virtuelle.

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

-Password

Spécifie le mot de passe du compte d’administrateur.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ResetPasswordOnFirstLogon

Indique que la machine virtuelle exige que l’utilisateur modifie le mot de passe lors de la première ouverture de session.

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

-SSHKeyPairs

Spécifie les paires de clés SSH.

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

-SSHPublicKeys

Spécifie des clés publiques SSH.

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

-TimeZone

Spécifie le fuseau horaire de la machine virtuelle, par exemple, Pacific Standard Time ou Canada Central Standard Time.

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

-VM

Spécifie un objet de machine virtuelle.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Windows

Indique que cette configuration crée une machine virtuelle autonome qui exécute le système d’exploitation Windows.

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

-WindowsDomain

Indique que cette configuration crée un serveur Windows joint à un domaine Active Directory.

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

-WinRMCertificate

Spécifie un certificat associé à cette configuration à un point de terminaison WinRM.

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

-X509Certificates

Spécifie un tableau de certificats X509 déployés sur un service hébergé.

Type:X509Certificate2[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False