Delen via

Set-AzVMADDomainExtension

  • Referentie
Module:
Az.Compute

Hiermee voegt u een AD-domeinextensie toe aan een virtuele machine.

Syntaxis

Set-AzVMADDomainExtension
   -DomainName <String>
   [-OUPath <String>]
   [-JoinOption <UInt32>]
   [-Credential <PSCredential>]
   [-Restart]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-AzVMADDomainExtension voegt een microsoft Entra ID-extensie voor virtuele machines toe aan een virtuele machine. Met deze extensie kan uw virtuele machine lid worden van een domein.

Voorbeelden

Voorbeeld 1

# Create a Resource Group and Virtual Machine before this.
$extensionName = "extensionName"
$virtualMachineName = "vmName"
$resourceGroupName = "resourceGroupName"
$domainName = "domain.com"
Set-AzVMADDomainExtension -ResourceGroupName $resourceGroupName -VMName $virtualMachineName -Name $extensionName -DomainName $domainName

RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
                         True         OK OK

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u de gebruikersnaam en het wachtwoord voor de virtuele machine op als een PSCredential-object . Gebruik de cmdlet Get-Credential om een referentie te verkrijgen. Typ voor meer informatie Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisableAutoUpgradeMinorVersion

Geeft aan dat deze cmdlet automatische upgrade van de secundaire versie van de extensie uitschakelt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DomainName

Hiermee geeft u de naam van het domein.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ForceRerun

Geeft aan dat met deze cmdlet dezelfde extensieconfiguratie op de virtuele machine opnieuw wordt uitgevoerd zonder de extensie te verwijderen en opnieuw te installeren. De waarde kan elke tekenreeks zijn die verschilt van de huidige waarde. Als forceUpdateTag niet wordt gewijzigd, worden updates voor openbare of beveiligde instellingen nog steeds toegepast door de handler.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-JoinOption

Hiermee geeft u de join-optie. Zie JoinOptions voor joinopties

Type:Nullable<T>[UInt32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Location

Hiermee geeft u de locatie van de virtuele machine.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de domeinextensie toe te voegen.

Type:String
Aliassen:ExtensionName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoWait

Start de bewerking en retourneert onmiddellijk voordat de bewerking is voltooid. Gebruik een ander mechanisme om te bepalen of de bewerking is voltooid.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OUPath

Hiermee geeft u een organisatie-eenheid (OE) voor het domeinaccount. Voer de volledige DN-naam van de organisatie-eenheid in tussen aanhalingstekens. De standaardwaarde is de standaard-OE voor machineobjecten in het domein.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Restart

Geeft aan dat met deze cmdlet de virtuele machine opnieuw wordt opgestart. Een herstart is vaak vereist om de wijziging effectief te maken.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-TypeHandlerVersion

Hiermee geeft u de versie van de domeinextensie.

Type:String
Aliassen:HandlerVersion, Version
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMName

Hiermee geeft u de naam van de virtuele machine.

Type:String
Aliassen:ResourceName
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

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

PSCredential

SwitchParameter

Uitvoerwaarden

PSAzureOperationResponse