Add-AzureProvisioningConfig

Référence

Module:: Azure

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

Remarque

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.

Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.

Syntaxe

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

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

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
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Certificates

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

Type:	CertificateSettingList
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableAutomaticUpdates

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableGuestAgent

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DisableSSH

Indique que cette configuration désactive SSH.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Domain

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DomainPassword

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DomainUserName

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EnableWinRMHttp

Indique que cette configuration active WinRM sur HTTP.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Demander
SilentlyContinue
Arrêter
Suspendre

Type:	ActionPreference
Alias:	infa
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InformationVariable

Spécifie une variable d’informations.

Type:	String
Alias:	iv
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-JoinDomain

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Linux

Indique que cette configuration crée une configuration Linux.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NoExportPrivateKey

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NoRDPEndpoint

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NoSSHEndpoint

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NoSSHPassword

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NoWinRMEndpoint

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Password

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SSHKeyPairs

Spécifie les paires de clés SSH.

Type:	SSHKeyPairList
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SSHPublicKeys

Spécifie des clés publiques SSH.

Type:	SSHPublicKeyList
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-VM

Spécifie un objet de machine virtuelle.

Type:	IPersistentVM
Alias:	InputObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WindowsDomain

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WinRMCertificate

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

Type:	X509Certificate2
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-X509Certificates

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

Type:	X509Certificate2[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Partager via