Share via


Set-AzureRmVMAccessExtension

Hozzáadja a VMAccess bővítményt egy virtuális géphez.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

Set-AzureRmVMAccessExtension
   [-Credential <PSCredential>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A Set-AzureRmVMAccessExtension parancsmag hozzáadja a Virtuálisgép-hozzáférés (VMAccess) virtuálisgép-VMAccess-bővítményt egy virtuális géphez. A VMAccess-bővítmény használható ideiglenes jelszó beállításához, és ezt a gépre való bejelentkezés után azonnal módosítani kell. Ez windowsos tartományvezérlők esetén nem támogatott.

Példák

1. példa: VMAccess-bővítmény hozzáadása

PS C:\> Set-AzureRmVMAccessExtension -ResourceGroupName "ResrouceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4" -UserName "PFuller" -Password "Password"

Ez a parancs hozzáad egy VMAccess-bővítményt a VirtualMachine07 nevű virtuális géphez a ResrouceGroup11-ben. A parancs a VMAccess nevét és típuskezelő verzióját adja meg.

Paraméterek

-Confirm

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

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

-Credential

PsCredential objektumként adja meg a virtuális gép felhasználónevet és jelszót. Ha a virtuális gépen a jelenlegi helyi rendszergazdai fióktól eltérő nevet ad meg, a VMAccess bővítmény hozzáad egy helyi rendszergazdai fiókot ezzel a névvel, és hozzárendeli a megadott jelszót ehhez a fiókhoz. Ha a virtuális gépen található helyi rendszergazdai fiók létezik, alaphelyzetbe állítja a jelszót, és ha a fiók le van tiltva, a VMAccess bővítmény engedélyezi azt. Hitelesítő adatok beszerzéséhez használja a Get-Credential parancsmagot. További információkért írja be a következőt Get-Help Get-Credential:

Type:PSCredential
Position:Named
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:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgradeMinorVersion

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

-ForceRerun

Azt jelzi, hogy ez a parancsmag ugyanazon bővítménykonfiguráció újrafuttatását kényszeríti a virtuális gépen a bővítmény eltávolítása és újratelepítése nélkül. Az érték bármilyen sztring lehet, amely eltér az aktuális értéktől. Ha a forceUpdateTag nem módosul, a kezelő továbbra is alkalmazza a nyilvános vagy védett beállítások frissítéseit.

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

-Location

Megadja a virtuális gép helyét.

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

-Name

Megadja a parancsmag által hozzáadott bővítmény nevét.

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

-ResourceGroupName

Megadja a virtuális gép erőforráscsoportjának nevét.

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

-TypeHandlerVersion

A virtuális géphez használandó bővítmény verzióját adja meg. A verzió beszerzéséhez futtassa a Get-AzureRmVMExtensionImage parancsmagot a PublisherName paraméterHez tartozó Microsoft.Compute és a Típus paraméter VMAccessAgent értékével. A TypeHandlerVersion típusnak 2.0-s vagy újabbnak kell lennie, mivel az 1. verzió elavult.

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

-VMName

A virtuális gép nevét adja meg. Ez a parancsmag hozzáadja a VMAccesst ahhoz a virtuális géphez, amelyet ez a paraméter megad.

Type:String
Aliases:ResourceName
Position:1
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:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

PSCredential

String

SwitchParameter

Kimenetek

PSAzureOperationResponse