Set-AzVmssOsProfile
Ustawia właściwości profilu systemu operacyjnego zestawu skalowania maszyn wirtualnych.
Składnia
Set-AzVmssOsProfile
[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
[[-ComputerNamePrefix] <String>]
[[-AdminUsername] <String>]
[[-AdminPassword] <String>]
[[-CustomData] <String>]
[[-WindowsConfigurationProvisionVMAgent] <Boolean>]
[-LinuxConfigurationProvisionVMAgent <Boolean>]
[[-WindowsConfigurationEnableAutomaticUpdate] <Boolean>]
[[-TimeZone] <String>]
[[-AdditionalUnattendContent] <AdditionalUnattendContent[]>]
[[-Listener] <WinRMListener[]>]
[[-LinuxConfigurationDisablePasswordAuthentication] <Boolean>]
[[-PublicKey] <SshPublicKey[]>]
[[-Secret] <VaultSecretGroup[]>]
[-WindowsConfigurationPatchMode <String>]
[-LinuxConfigurationPatchMode <String>]
[-EnableHotpatching]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Set-AzVmssOsProfile ustawia właściwości profilu systemu operacyjnego zestawu skalowania maszyn wirtualnych.
Przykłady
Przykład 1. Ustawianie właściwości profilu systemu operacyjnego dla zestawu skalowania maszyn wirtualnych
$vmss = New-AzVmssConfig -Location $Loc -SkuCapacity 2 -SkuName "Standard_A0" -UpgradePolicyMode "Automatic" -NetworkInterfaceConfiguration $NetCfg
Set-AzVmssOsProfile -VirtualMachineScaleSet $vmss -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword
To polecenie ustawia właściwości profilu systemu operacyjnego dla obiektu $vmss. Polecenie ustawia prefiks nazwy komputera dla wszystkich wystąpień maszyn wirtualnych w zestawie skalowania maszyn wirtualnych do testowania i dostarcza nazwę użytkownika i hasło administratora.
Przykład 2. Ustawianie właściwości profilu systemu operacyjnego dla maszyn wirtualnych w trybie elastycznym z włączoną funkcją Hotpatching.
# Setup variables.
$loc = "eastus";
$rgname = "<Resource Group Name>";
$vmssName = "myVmssSlb";
$vmNamePrefix = "vmSlb";
$vmssInstanceCount = 5;
$vmssSku = "Standard_DS1_v2";
$vnetname = "myVnet";
$vnetAddress = "10.0.0.0/16";
$subnetname = "default-slb";
$subnetAddress = "10.0.2.0/24";
$securePassword = "<Password>" | ConvertTo-SecureString -AsPlainText -Force;
$cred = New-Object System.Management.Automation.PSCredential ("<Username>", $securePassword);
# VMSS Flex requires explicit outbound access.
# Create a virtual network.
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name $subnetname -AddressPrefix $subnetAddress;
$virtualNetwork = New-AzVirtualNetwork -Name $vnetname -ResourceGroupName $rgname -Location $loc -AddressPrefix $vnetAddress -Subnet $frontendSubnet;
# Create a public IP address.
$publicIP = New-AzPublicIpAddress `
-ResourceGroupName $rgname `
-Location $loc `
-AllocationMethod Static `
-Sku "Standard" `
-IpAddressVersion "IPv4" `
-Name "myLBPublicIP";
# Create a frontend and backend IP pool.
$frontendIP = New-AzLoadBalancerFrontendIpConfig `
-Name "myFrontEndPool" `
-PublicIpAddress $publicIP;
$backendPool = New-AzLoadBalancerBackendAddressPoolConfig -Name "myBackEndPool" ;
# Create the load balancer.
$lb = New-AzLoadBalancer `
-ResourceGroupName $rgname `
-Name "myLoadBalancer" `
-Sku "Standard" `
-Tier "Regional" `
-Location $loc `
-FrontendIpConfiguration $frontendIP `
-BackendAddressPool $backendPool;
# Create a load balancer health probe for TCP port 80.
Add-AzLoadBalancerProbeConfig -Name "myHealthProbe" `
-LoadBalancer $lb `
-Protocol TCP `
-Port 80 `
-IntervalInSeconds 15 `
-ProbeCount 2;
# Create a load balancer rule to distribute traffic on port TCP 80.
# The health probe from the previous step is used to make sure that traffic is
# only directed to healthy VM instances.
Add-AzLoadBalancerRuleConfig `
-Name "myLoadBalancerRule" `
-LoadBalancer $lb `
-FrontendIpConfiguration $lb.FrontendIpConfigurations[0] `
-BackendAddressPool $lb.BackendAddressPools[0] `
-Protocol TCP `
-FrontendPort 80 `
-BackendPort 80 `
-DisableOutboundSNAT `
-Probe (Get-AzLoadBalancerProbeConfig -Name "myHealthProbe" -LoadBalancer $lb);
# Add outbound connectivity rule.
Add-AzLoadBalancerOutboundRuleConfig `
-Name "outboundrule" `
-LoadBalancer $lb `
-AllocatedOutboundPort '10000' `
-Protocol 'All' `
-IdleTimeoutInMinutes '15' `
-FrontendIpConfiguration $lb.FrontendIpConfigurations[0] `
-BackendAddressPool $lb.BackendAddressPools[0];
# Update the load balancer configuration.
Set-AzLoadBalancer -LoadBalancer $lb;
# Create IP address configurations.
# Instances will require explicit outbound connectivity, for example
# - NAT Gateway on the subnet (recommended)
# - Instances in backend pool of Standard LB with outbound connectivity rules
# - Public IP address on each instance
# See aka.ms/defaultoutboundaccess for more info.
$ipConfig = New-AzVmssIpConfig `
-Name "myIPConfig" `
-SubnetId $virtualNetwork.Subnets[0].Id `
-LoadBalancerBackendAddressPoolsId $lb.BackendAddressPools[0].Id `
-Primary;
# Create a config object.
# The Vmss config object stores the core information for creating a scale set.
$vmssConfig = New-AzVmssConfig `
-Location $loc `
-SkuCapacity $vmssInstanceCount `
-SkuName $vmssSku `
-OrchestrationMode 'Flexible' `
-PlatformFaultDomainCount 1;
# Reference a virtual machine image from the gallery.
Set-AzVmssStorageProfile $vmssConfig `
-OsDiskCreateOption "FromImage" `
-ImageReferencePublisher "MicrosoftWindowsServer" `
-ImageReferenceOffer "WindowsServer" `
-ImageReferenceSku "2022-datacenter-azure-edition-core-smalldisk" `
-ImageReferenceVersion "latest";
# Set up information for authenticating with the virtual machine.
Set-AzVmssOsProfile $vmssConfig `
-AdminUsername $cred.UserName `
-AdminPassword $cred.Password `
-ComputerNamePrefix $vmNamePrefix `
-WindowsConfigurationProvisionVMAgent $true `
-WindowsConfigurationPatchMode "AutomaticByPlatform" `
-EnableHotpatching;
# Attach the virtual network to the config object.
Add-AzVmssNetworkInterfaceConfiguration `
-VirtualMachineScaleSet $vmssConfig `
-Name "network-config" `
-Primary $true `
-IPConfiguration $ipConfig `
-NetworkApiVersion '2020-11-01';
# Define the Application Health extension properties.
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"};
$extensionName = "myHealthExtension";
$extensionType = "ApplicationHealthWindows";
$publisher = "Microsoft.ManagedServices";
# Add the Application Health extension to the scale set model.
Add-AzVmssExtension -VirtualMachineScaleSet $vmssConfig `
-Name $extensionName `
-Publisher $publisher `
-Setting $publicConfig `
-Type $extensionType `
-TypeHandlerVersion "1.0" `
-AutoUpgradeMinorVersion $True;
# Create the virtual machine scale set.
$vmss = New-AzVmss `
-ResourceGroupName $rgname `
-Name $vmssName `
-VirtualMachineScaleSet $vmssConfig;
Ustawianie właściwości profilu systemu operacyjnego dla maszyn wirtualnych w trybie elastycznym z włączoną funkcją Hotpatching
Parametry
-AdditionalUnattendContent
Określa obiekt zawartości nienadzorowanej. Aby utworzyć obiekt, możesz użyć polecenia Add-AzVMAdditionalUnattendContent.
Type: | AdditionalUnattendContent[] |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AdminPassword
Określa hasło administratora do użycia dla wszystkich wystąpień maszyn wirtualnych w zestawie skalowania maszyn wirtualnych.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AdminUsername
Określa nazwę konta administratora do użycia dla wszystkich wystąpień maszyn wirtualnych w zestawie skalowania maszyn wirtualnych.
Ograniczenie:
Windows: Nie można zawierać znaków specjalnych /"[]:|<>+=;,?*@& lub end in "."
Linux: nazwa użytkownika musi zawierać tylko litery, cyfry, łączniki i podkreślenia i może nie zaczynać się od łącznika lub liczby.
Niedozwolone wartości: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".
Minimalna długość: 1 znak
Maksymalna długość: 20 znaków dla systemu Windows, 64 znaki dla systemu Linux
Aby uzyskać listę wbudowanych użytkowników systemu w systemie Linux, których nie należy używać w tym polu, zobacz Wybieranie nazw użytkowników dla systemu Linux na platformie Azure.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerNamePrefix
Określa prefiks nazwy komputera dla wszystkich wystąpień maszyn wirtualnych w zestawie skalowania maszyn wirtualnych. Nazwy komputerów muszą mieć długość od 1 do 15 znaków.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CustomData
Określa ciąg zakodowany w formacie base-64 danych niestandardowych.
Jest to dekodowane do tablicy binarnej, która jest zapisywana jako plik na maszynie wirtualnej.
Maksymalna długość tablicy binarnej wynosi 65535 bajtów.
Aby użyć pakietu cloud-init dla maszyny wirtualnej, zobacz Using cloud-init to customize a Linux VM during creation (Używanie pakietu cloud-init do dostosowywania maszyny wirtualnej z systemem Linux podczas tworzenia).
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableHotpatching
Umożliwia klientom stosowanie poprawek maszyn wirtualnych platformy Azure bez konieczności ponownego uruchamiania. W przypadku funkcji enableHotpatching parametr "provisionVMAgent" musi być ustawiony na wartość true, a parametr "patchMode" musi być ustawiony na wartość "AutomaticByPlatform".
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LinuxConfigurationDisablePasswordAuthentication
Wskazuje, że to polecenie cmdlet wyłącza uwierzytelnianie haseł.
Type: | Nullable<T>[Boolean] |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LinuxConfigurationPatchMode
Określa tryb stosowania poprawek gościa maszyny wirtualnej do maszyny wirtualnej IaaS lub maszyn wirtualnych skojarzonych z zestawem skalowania maszyn wirtualnych z funkcją OrchestrationMode jako elastyczny.
Dopuszczalne wartości:
ImageDefault — używana jest domyślna konfiguracja stosowania poprawek maszyny wirtualnej.
AutomaticByPlatform — maszyna wirtualna zostanie automatycznie zaktualizowana przez platformę. Właściwość provisionVMAgent musi mieć wartość true
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LinuxConfigurationProvisionVMAgent
Wskazuje, czy agent maszyny wirtualnej powinien być aprowizowany na maszynie wirtualnej.
Jeśli ta właściwość nie jest określona w treści żądania, domyślne zachowanie to ustawienie wartości true. Dzięki temu agent maszyny wirtualnej jest zainstalowany na maszynie wirtualnej, aby można było później dodać rozszerzenia do maszyny wirtualnej
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Listener
Określa odbiorniki zdalnego zarządzania systemem Windows (WinRM). Umożliwia to zdalne środowisko Windows PowerShell. Aby utworzyć odbiornik, możesz użyć polecenia cmdlet Add-AzVmssWinRMListener.
Type: | WinRMListener[] |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicKey
Określa obiekt klucza publicznego secure shell (SSH). Aby utworzyć obiekt, możesz użyć polecenia cmdlet Add-AzVMSshPublicKey.
Type: | SshPublicKey[] |
Position: | 11 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Secret
Określa obiekt wpisów tajnych, który zawiera odwołania do certyfikatu do umieszczenia na maszynie wirtualnej. Aby utworzyć obiekt wpisów tajnych, możesz użyć polecenia cmdlet Add-AzVmssSecret.
Type: | VaultSecretGroup[] |
Position: | 12 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeZone
Określa strefę czasową maszyny wirtualnej. np. "Pacyfik (czas standardowy).
Możliwe wartości mogą być TimeZoneInfo.Id wartości ze stref czasowych zwracanych przez timeZoneInfo.GetSystemTimeZones.
Type: | String |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VirtualMachineScaleSet
Określa obiekt VMSS. Aby utworzyć obiekt, możesz użyć polecenia cmdlet New-AzVmssConfig.
Type: | PSVirtualMachineScaleSet |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WindowsConfigurationEnableAutomaticUpdate
Wskazuje, czy maszyny wirtualne w zestawie skalowania maszyn wirtualnych są włączone na potrzeby aktualizacji automatycznych.
Type: | Nullable<T>[Boolean] |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WindowsConfigurationPatchMode
Określa tryb stosowania poprawek gościa maszyny wirtualnej do maszyny wirtualnej IaaS lub maszyn wirtualnych skojarzonych z zestawem skalowania maszyn wirtualnych z funkcją OrchestrationMode jako elastyczny.
Dopuszczalne wartości:
Ręczne — kontrolujesz stosowanie poprawek do maszyny wirtualnej. W tym celu należy ręcznie zastosować poprawki wewnątrz maszyny wirtualnej. W tym trybie aktualizacje automatyczne są wyłączone; właściwość WindowsConfiguration.enableAutomatic Aktualizacje musi mieć wartość false
AutomaticByOS — maszyna wirtualna zostanie automatycznie zaktualizowana przez system operacyjny. Właściwość WindowsConfiguration.enableAutomatic Aktualizacje musi mieć wartość true.
AutomaticByPlatform — maszyna wirtualna zostanie automatycznie zaktualizowana przez platformę. Właściwości provisionVMAgent i WindowsConfiguration.enableAutomatic Aktualizacje muszą mieć wartość true
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WindowsConfigurationProvisionVMAgent
Wskazuje, czy agent maszyny wirtualnej powinien być aprowizowany na maszynach wirtualnych w zestawie skalowania maszyn wirtualnych.
Type: | Nullable<T>[Boolean] |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Dane wyjściowe
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla