Add-AzureProvisioningConfig

Odwołanie

Moduł:: Azure

Dodaje konfigurację aprowizacji dla maszyny wirtualnej platformy Azure.

Uwaga

Polecenia cmdlet, do których odwołuje się ta dokumentacja, służą do zarządzania starszymi zasobami platformy Azure korzystającymi z interfejsów API programu Azure Service Manager (ASM). Ten starszy moduł programu PowerShell nie jest zalecany podczas tworzenia nowych zasobów, ponieważ usługa ASM ma zostać wycofana. Aby uzyskać więcej informacji, zobacz Wycofywanie programu Azure Service Manager.

Moduł Az programu PowerShell jest zalecanym modułem programu PowerShell do zarządzania zasobami usługi Azure Resource Manager (ARM) przy użyciu programu PowerShell.

Składnia

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>]

Opis

Polecenie cmdlet Add-AzureProvisioningConfig dodaje informacje o konfiguracji aprowizacji do konfiguracji maszyny wirtualnej platformy Azure. Za pomocą obiektu konfiguracji można utworzyć maszynę wirtualną.

To polecenie cmdlet obsługuje różne konfiguracje aprowizacji, w tym autonomiczne serwery z systemem Windows, serwery z systemem Windows przyłączone do domeny usługi Active Directory i serwery oparte na systemie Linux.

Aby utworzyć serwer przyłączony do domeny usługi Active Directory, określ w pełni kwalifikowaną nazwę domeny usługi Active Directory i poświadczenia domeny użytkownika, który ma uprawnienia do przyłączenia maszyny wirtualnej do domeny.

Przykłady

Przykład 1. Tworzenie autonomicznej maszyny wirtualnej

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

To polecenie tworzy obiekt konfiguracji maszyny wirtualnej przy użyciu polecenia cmdlet New-AzureVMConfig . Polecenie przekazuje ten obiekt do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet dodaje konfigurację aprowizacji dla maszyny wirtualnej z systemem operacyjnym Windows. Konfiguracja obejmuje nazwę użytkownika administratora i hasło. Polecenie przekazuje konfigurację do polecenia cmdlet New-AzureVM , które tworzy maszynę wirtualną.

Przykład 2. Tworzenie maszyny wirtualnej przyłączonej do domeny

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"

To polecenie tworzy obiekt konfiguracji maszyny wirtualnej, a następnie przekazuje go do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje konfigurację aprowizacji maszyny wirtualnej, która ma zostać przyłączona do domeny contoso. Polecenie zawiera nazwę użytkownika i hasło niezbędne do przyłączenia maszyny wirtualnej do domeny. Konfiguracja wymaga od użytkownika zmiany hasła użytkownika podczas pierwszego logowania. Polecenie tworzy maszynę wirtualną na podstawie obiektu aprowizacji.

Przykład 3. Tworzenie maszyny wirtualnej opartej na systemie Linux

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

To polecenie tworzy obiekt konfiguracji maszyny wirtualnej, a następnie przekazuje go do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje konfigurację aprowizacji dla maszyny wirtualnej z systemem operacyjnym Linux. Konfiguracja zawiera nazwę użytkownika głównego i hasło. Polecenie tworzy maszynę wirtualną na podstawie obiektu aprowizacji.

Przykład 4. Tworzenie maszyny wirtualnej zawierającej certyfikaty dla usługi 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

Pierwsze polecenie pobiera certyfikaty z magazynu certyfikatów, a następnie przechowuje je w zmiennej tablicy $certs.

Drugie polecenie tworzy obiekt konfiguracji maszyny wirtualnej, a następnie przekazuje go do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje konfigurację aprowizacji, która zawiera certyfikaty dla usługi WinRM. Polecenie tworzy maszynę wirtualną na podstawie obiektu aprowizacji.

Przykład 5. Tworzenie maszyny wirtualnej z włączoną usługą WinRM za pośrednictwem protokołu HTTP

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

To polecenie tworzy obiekt konfiguracji maszyny wirtualnej, a następnie przekazuje go do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje konfigurację aprowizacji, która ma włączoną usługę WinRM za pośrednictwem protokołu HTTP. Polecenie tworzy maszynę wirtualną na podstawie obiektu aprowizacji.

Przykład 6. Tworzenie maszyny wirtualnej, która ma wyłączoną usługę WinRM za pośrednictwem protokołu HTTPS

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

Przykład 7. Tworzenie maszyny wirtualnej bez eksportu klucza

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

Pierwsze polecenie pobiera certyfikaty z magazynu certyfikatów, a następnie przechowuje je w zmiennej tablicy $certs.

Drugie polecenie tworzy obiekt konfiguracji maszyny wirtualnej, a następnie przekazuje go do bieżącego polecenia cmdlet. Bieżące polecenie cmdlet dodaje konfigurację aprowizacji dla maszyny wirtualnej, która zawiera certyfikaty i nie eksportuje kluczy prywatnych. Polecenie tworzy maszynę wirtualną na podstawie obiektu aprowizacji.

Parametry

-AdminUsername

Określa nazwę użytkownika konta administratora, które ta konfiguracja tworzy na maszynie wirtualnej.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Certificates

Określa zestaw certyfikatów instalowanych przez tę konfigurację na maszynie wirtualnej.

Typ:	CertificateSettingList
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomDataFile

Określa plik danych dla maszyny wirtualnej. To polecenie cmdlet koduje zawartość pliku jako Base64. Plik musi być mniejszy niż 64 kilobajty długości.

Jeśli system operacyjny gościa jest systemem operacyjnym Windows, ta konfiguracja zapisuje te dane jako plik binarny o nazwie %SYSTEMDRIVE%\AzureData\CustomData.bin.

Jeśli system operacyjny gościa to Linux, ta konfiguracja przekazuje dane przy użyciu pliku ovf-env.xml. Konfiguracja kopiuje ten plik do katalogu /var/lib/waagent. Agent przechowuje również dane zakodowane w formacie Base64 w /var/lib/waagent/CustomData.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAutomaticUpdates

Wskazuje, że ta konfiguracja wyłącza aktualizacje automatyczne.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableGuestAgent

Wskazuje, że ta konfiguracja wyłącza agenta gościa infrastruktury jako usługi (IaaS).

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableSSH

Wskazuje, że ta konfiguracja wyłącza protokół SSH.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWinRMHttps

Wskazuje, że ta konfiguracja wyłącza zdalne zarządzanie systemem Windows (WinRM) w protokole HTTPS. Domyślnie usługa WinRM jest włączona za pośrednictwem protokołu HTTPS.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Domain

Określa nazwę domeny konta, które ma uprawnienia do dodawania komputera do domeny.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainPassword

Określa hasło konta użytkownika, które ma uprawnienia do dodawania komputera do domeny.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainUserName

Określa nazwę konta użytkownika, które ma uprawnienia do dodawania komputera do domeny.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableWinRMHttp

Wskazuje, że ta konfiguracja włącza usługę WinRM za pośrednictwem protokołu HTTP.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Określa, jak to polecenie cmdlet reaguje na zdarzenie informacyjne.

Dopuszczalne wartości tego parametru to:

Kontynuuj
Ignoruj
Zapytać
SilentlyContinue
Zatrzymaj
Wstrzymanie

Typ:	ActionPreference
Aliases:	infa
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Określa zmienną informacyjną.

Typ:	String
Aliases:	iv
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JoinDomain

Określa w pełni kwalifikowaną nazwę domeny (FQDN) domeny do przyłączenia.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Linux

Wskazuje, że ta konfiguracja tworzy konfigurację systemu Linux.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LinuxUser

Określa nazwę użytkownika konta administracyjnego systemu Linux, które ta konfiguracja tworzy na maszynie wirtualnej.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MachineObjectOU

Określa w pełni kwalifikowaną nazwę jednostki organizacyjnej, w której konfiguracja tworzy konto komputera.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoExportPrivateKey

Wskazuje, że ta konfiguracja nie przekazuje klucza prywatnego.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRDPEndpoint

Wskazuje, że ta konfiguracja tworzy maszynę wirtualną bez punktu końcowego pulpitu zdalnego.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSSHEndpoint

Wskazuje, że ta konfiguracja tworzy maszynę wirtualną bez punktu końcowego SSH.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSSHPassword

Wskazuje, że ta konfiguracja tworzy maszynę wirtualną bez hasła SSH.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWinRMEndpoint

Wskazuje, że ta konfiguracja nie dodaje punktu końcowego usługi WinRM dla maszyny wirtualnej.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

Określa hasło konta administratora.

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Profile

Określa profil platformy Azure, z którego to polecenie cmdlet odczytuje. Jeśli nie określisz profilu, to polecenie cmdlet odczytuje z lokalnego profilu domyślnego.

Typ:	AzureSMProfile
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResetPasswordOnFirstLogon

Wskazuje, że maszyna wirtualna wymaga od użytkownika zmiany hasła podczas pierwszego logowania.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHKeyPairs

Określa pary kluczy SSH.

Typ:	SSHKeyPairList
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHPublicKeys

Określa klucze publiczne SSH.

Typ:	SSHPublicKeyList
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeZone

Określa strefę czasową maszyny wirtualnej, na przykład Pacyfik (czas standardowy) lub Canada Central (czas standardowy).

Typ:	String
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VM

Określa obiekt maszyny wirtualnej.

Typ:	IPersistentVM
Aliases:	InputObject
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Windows

Wskazuje, że ta konfiguracja tworzy autonomiczną maszynę wirtualną z systemem operacyjnym Windows.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowsDomain

Wskazuje, że ta konfiguracja tworzy serwer z systemem Windows przyłączony do domeny usługi Active Directory.

Typ:	SwitchParameter
Position:	Named
wartość domyślna:	None
Wymagane:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WinRMCertificate

Określa certyfikat, który ta konfiguracja kojarzy z punktem końcowym usługi WinRM.

Typ:	X509Certificate2
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-X509Certificates

Określa tablicę certyfikatów X509 wdrożonych w hostowanej usłudze.

Typ:	X509Certificate2[]
Position:	Named
wartość domyślna:	None
Wymagane:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Udostępnij za pośrednictwem