Set-AzVmssOsProfile

Beállítja a VMSS operációsrendszer-profil tulajdonságait.

Syntax

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

Description

A Set-AzVmssOsProfile parancsmag beállítja a virtuálisgép-méretezési csoport operációsrendszer-profil tulajdonságait.

Példák

1. példa: VMSS operációsrendszer-profiltulajdonságainak beállítása

$vmss = New-AzVmssConfig -Location $Loc -SkuCapacity 2 -SkuName "Standard_A0" -UpgradePolicyMode "Automatic" -NetworkInterfaceConfiguration $NetCfg
Set-AzVmssOsProfile -VirtualMachineScaleSet $vmss -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword

Ez a parancs beállítja az operációsrendszer-profil tulajdonságait a $vmss objektumhoz. A parancs a VMSS összes virtuálisgép-példányához beállítja a számítógépnév előtagját a rendszergazdai felhasználónév és jelszó teszteléséhez és megadásához.

2. példa: Állítsa be az operációsrendszer-profil tulajdonságait egy rugalmas módban lévő virtuális gépekhez, és engedélyezve van a gyorselérési mód.

# 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;

Virtuális gépek operációsrendszer-profiltulajdonságainak beállítása rugalmas módban, a hotpatching engedélyezése mellett

Paraméterek

-AdditionalUnattendContent

Felügyelet nélküli tartalomobjektumot ad meg. Az objektum létrehozásához használhatja az Add-AzVMAdditionalUnattendContent parancsot.

Type:AdditionalUnattendContent[]
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AdminPassword

Megadja a VMSS összes virtuálisgép-példányához használandó rendszergazdai jelszót.

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

-AdminUsername

Megadja a VMSS összes virtuálisgép-példányához használandó rendszergazdai fióknevet.
Korlátozás:
Windows: Nem tartalmazhat speciális karaktereket /""[]:|<>+=;,?*@> vagy "".
Linux: A felhasználónév csak betűket, számokat, kötőjeleket és aláhúzásjeleket tartalmazhat, és nem kezdődhet kötőjellel vagy számmal.
Nem engedélyezett értékek: "rendszergazda", "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".
Minimális hossz: 1 karakter
Maximális hossz: 20 karakter Windows esetén, 64 karakter Linux esetén
Azoknak a linuxos beépített rendszerfelhasználóknak a listáját, amelyeket ebben a mezőben nem érdemes használni, olvassa el a Felhasználónevek kiválasztása Linuxhoz az Azure-ban című témakört.

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

-ComputerNamePrefix

Megadja a virtuális gép összes virtuálisgép-példányának számítógépnév-előtagját a VMSS-ben. A számítógépneveknek 1–15 karakter hosszúságúnak kell lenniük.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-CustomData

Az egyéni adatok base-64 kódolású sztringét adja meg. Ez egy bináris tömbre van dekódolva, amely fájlként van mentve a virtuális gépen. A bináris tömb maximális hossza 65535 bájt.
A cloud-init virtuális géphez való használatáról a Linux rendszerű virtuális gépek létrehozásakor a Cloud-init használatával történő testreszabásával kapcsolatban olvashat.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableHotpatching

Lehetővé teszi, hogy az ügyfelek újraindítás nélkül javíthassák az Azure-beli virtuális gépeiket. Az enableHotpatching esetében a "provisionVMAgent" értéknek igaznak kell lennie, a "patchMode" értéknek pedig az "AutomaticByPlatform" értékre kell állítania.

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

-LinuxConfigurationDisablePasswordAuthentication

Azt jelzi, hogy ez a parancsmag letiltja a jelszó-hitelesítést.

Type:Nullable<T>[Boolean]
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LinuxConfigurationPatchMode

Meghatározza a virtuálisgép-vendégjavítás módját az IaaS virtuális gépen vagy a virtuálisgép-méretezési csoporthoz társított virtuális gépeken, rugalmasként az OrchestrationMode használatával.

A lehetséges értékek a következők:

ImageDefault – A rendszer a virtuális gép alapértelmezett javítási konfigurációját használja.

AutomaticByPlatform – A platform automatikusan frissíti a virtuális gépet. A provisionVMAgent tulajdonságnak igaznak kell lennie

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

-LinuxConfigurationProvisionVMAgent

Azt jelzi, hogy a virtuálisgép-ügynököt ki kell-e helyezni a virtuális gépen.

Ha ez a tulajdonság nincs megadva a kérelem törzsében, az alapértelmezett viselkedés a true (igaz) értékre állítása. Ez biztosítja, hogy a virtuálisgép-ügynök telepítve legyen a virtuális gépen, hogy a bővítmények később hozzáadhatók legyenek a virtuális géphez

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Listener

A Windows Remote Management (WinRM) figyelőit adja meg. Ez lehetővé teszi a távoli Windows PowerShell használatát. Az Add-AzVmssWinRMListener parancsmaggal létrehozhatja a figyelőt.

Type:WinRMListener[]
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicKey

A Secure Shell (SSH) nyilvános kulcs objektumát adja meg. Az Objektum létrehozásához használhatja az Add-AzVMSshPublicKey parancsmagot.

Type:SshPublicKey[]
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Secret

Megadja a virtuális gépen elhelyezendő tanúsítványhivatkozásokat tartalmazó titkos kulcsobjektumot. Az Add-AzVmssSecret parancsmaggal létrehozhatja a titkos kulcs objektumot.

Type:VaultSecretGroup[]
Position:12
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeZone

Megadja a virtuális gép időzónáját. pl. "Csendes-óceáni téli idő".
A lehetséges értékek a TimeZoneInfo.GetSystemTimeZones által visszaadott időzónákból TimeZoneInfo.Id értékek.

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

-VirtualMachineScaleSet

Megadja a VMSS-objektumot. Az objektum létrehozásához használhatja a New-AzVmssConfig parancsmagot.

Type:PSVirtualMachineScaleSet
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

-WindowsConfigurationEnableAutomaticUpdate

Azt jelzi, hogy a VMSS virtuális gépei engedélyezve vannak-e az automatikus frissítésekhez.

Type:Nullable<T>[Boolean]
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WindowsConfigurationPatchMode

Meghatározza a virtuálisgép-vendégjavítás módját az IaaS virtuális gépen vagy a virtuálisgép-méretezési csoporthoz társított virtuális gépeken, rugalmasként az OrchestrationMode használatával.

A lehetséges értékek a következők:

Manuális – A javítások virtuális gépre való alkalmazását szabályozhatja. Ezt úgy teheti meg, hogy manuálisan alkalmazza a javításokat a virtuális gépen belül. Ebben a módban az automatikus frissítések le vannak tiltva; a WindowsConfiguration.enableAutomatic tulajdonságnak hamisnak kell lennie Frissítések

AutomaticByOS – A virtuális gépet az operációs rendszer automatikusan frissíti. A WindowsConfiguration.enableAutomatic Frissítések tulajdonságnak igaznak kell lennie.

AutomaticByPlatform – a virtuális gépet a platform automatikusan frissíti. A provisionVMAgent és a WindowsConfiguration.enableAutomatic tulajdonságnak igaznak kell lennie Frissítések

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

-WindowsConfigurationProvisionVMAgent

Azt jelzi, hogy a virtuálisgép-ügynököt ki kell-e helyezni a virtuális gépeken a VMSS-ben.

Type:Nullable<T>[Boolean]
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Bevitelek

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

AdditionalUnattendContent[]

WinRMListener[]

SshPublicKey[]

VaultSecretGroup[]

Kimenetek

PSVirtualMachineScaleSet