Add-AzureProvisioningConfig
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
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 wyłącza usługę WinRM za pośrednictwem protokołu HTTPS. Polecenie tworzy maszynę wirtualną na podstawie obiektu aprowizacji.
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 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Certificates
Określa zestaw certyfikatów instalowanych przez tę konfigurację na maszynie wirtualnej.
Typ: | CertificateSettingList |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DisableAutomaticUpdates
Wskazuje, że ta konfiguracja wyłącza aktualizacje automatyczne.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DisableGuestAgent
Wskazuje, że ta konfiguracja wyłącza agenta gościa infrastruktury jako usługi (IaaS).
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DisableSSH
Wskazuje, że ta konfiguracja wyłącza protokół SSH.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Domain
Określa nazwę domeny konta, które ma uprawnienia do dodawania komputera do domeny.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DomainPassword
Określa hasło konta użytkownika, które ma uprawnienia do dodawania komputera do domeny.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DomainUserName
Określa nazwę konta użytkownika, które ma uprawnienia do dodawania komputera do domeny.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-EnableWinRMHttp
Wskazuje, że ta konfiguracja włącza usługę WinRM za pośrednictwem protokołu HTTP.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Aliasy: | infa |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InformationVariable
Określa zmienną informacyjną.
Typ: | String |
Aliasy: | iv |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-JoinDomain
Określa w pełni kwalifikowaną nazwę domeny (FQDN) domeny do przyłączenia.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Linux
Wskazuje, że ta konfiguracja tworzy konfigurację systemu Linux.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-LinuxUser
Określa nazwę użytkownika konta administracyjnego systemu Linux, które ta konfiguracja tworzy na maszynie wirtualnej.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MachineObjectOU
Określa w pełni kwalifikowaną nazwę jednostki organizacyjnej, w której konfiguracja tworzy konto komputera.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NoExportPrivateKey
Wskazuje, że ta konfiguracja nie przekazuje klucza prywatnego.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NoRDPEndpoint
Wskazuje, że ta konfiguracja tworzy maszynę wirtualną bez punktu końcowego pulpitu zdalnego.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NoSSHEndpoint
Wskazuje, że ta konfiguracja tworzy maszynę wirtualną bez punktu końcowego SSH.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NoSSHPassword
Wskazuje, że ta konfiguracja tworzy maszynę wirtualną bez hasła SSH.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NoWinRMEndpoint
Wskazuje, że ta konfiguracja nie dodaje punktu końcowego usługi WinRM dla maszyny wirtualnej.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Password
Określa hasło konta administratora.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResetPasswordOnFirstLogon
Wskazuje, że maszyna wirtualna wymaga od użytkownika zmiany hasła podczas pierwszego logowania.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SSHKeyPairs
Określa pary kluczy SSH.
Typ: | SSHKeyPairList |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-SSHPublicKeys
Określa klucze publiczne SSH.
Typ: | SSHPublicKeyList |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-TimeZone
Określa strefę czasową maszyny wirtualnej, na przykład Pacyfik (czas standardowy) lub Canada Central (czas standardowy).
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-VM
Określa obiekt maszyny wirtualnej.
Typ: | IPersistentVM |
Aliasy: | InputObject |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Windows
Wskazuje, że ta konfiguracja tworzy autonomiczną maszynę wirtualną z systemem operacyjnym Windows.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WindowsDomain
Wskazuje, że ta konfiguracja tworzy serwer z systemem Windows przyłączony do domeny usługi Active Directory.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WinRMCertificate
Określa certyfikat, który ta konfiguracja kojarzy z punktem końcowym usługi WinRM.
Typ: | X509Certificate2 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-X509Certificates
Określa tablicę certyfikatów X509 wdrożonych w hostowanej usłudze.
Typ: | X509Certificate2[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |