Connect-AzConnectedMachine
API zum Registrieren eines neuen Computers und damit zum Erstellen einer nachverfolgten Ressource in ARM
Syntax
Connect-AzConnectedMachine
[-ResourceGroupName] <String>
[[-SubscriptionId] <String>]
[[-Name] <String>]
[-Location] <String>
[[-PSSession] <PSSession[]>]
[[-Tag] <Hashtable>]
[[-DefaultProfile] <PSObject>]
[[-Proxy] <Uri>]
[<CommonParameters>]
Beschreibung
API zum Registrieren eines neuen Computers und damit zum Erstellen einer nachverfolgten Ressource in ARM
Beispiele
Beispiel 1: Onboarding des Computers, auf dem Sie sich als verbundener Computer befinden
Connect-AzConnectedMachine -ResourceGroupName contoso-connected-machines -Name linux_eastus1_1 -Location eastus
< truncated output of installing the azcmagent >
time="2020-08-07T13:13:25-07:00" level=info msg="Onboarding Machine. It usually takes a few minutes to complete. Sometimes it may take longer depending on network and server load status."
time="2020-08-07T13:13:25-07:00" level=info msg="Check network connectivity to all endpoints..."
time="2020-08-07T13:13:29-07:00" level=info msg="All endpoints are available... continue onboarding"
time="2020-08-07T13:13:50-07:00" level=info msg="Successfully Onboarded Resource to Azure" VM Id=********-****-****-****-**********
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
linux_eastus1_1 eastus linux Connected Succeeded
Integriert den Computer, auf dem Sie sich als verbundener Computer befinden.
Beispiel 2: Onboarding eines Remotecomputers als verbundenes Gerät
$session = Connect-PSSession -ComputerName WINBOX
Connect-AzConnectedMachine -ResourceGroupName contoso-rg -Name win_eastus1_1 -Location eastus -PSSession $session
< truncated output of installing the azcmagent >
time="2020-08-07T13:13:25-07:00" level=info msg="Onboarding Machine. It usually takes a few minutes to complete. Sometimes it may take longer depending on network and server load status."
time="2020-08-07T13:13:25-07:00" level=info msg="Check network connectivity to all endpoints..."
time="2020-08-07T13:13:29-07:00" level=info msg="All endpoints are available... continue onboarding"
time="2020-08-07T13:13:50-07:00" level=info msg="Successfully Onboarded Resource to Azure" VM Id=********-****-****-****-**********
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
win_eastus1_1 eastus windows Connected Succeeded
Integriert einen Remotecomputer als verbundenes Gerät mithilfe von PowerShell-Remoting. Hinweis: Derzeit wird nur Windows als Ziel unterstützt.
Parameter
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Typ: | PSObject |
Aliase: | AzureRMContext, AzureCredential |
Position: | 5 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Location
Der Speicherort für die erstellte ConnectedMachine.
Typ: | String |
Position: | 3 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Der Name, der für diesen Computer verwendet wird. Der Hostname wird standardmäßig verwendet.
Typ: | String |
Position: | 4 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Proxy
Der URI für den zu verwendenden Proxyserver
Typ: | Uri |
Position: | 8 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-PSSession
Wenn angegeben, wird der Befehl, der Computer in Azure integriert, in jeder PSSession ausgeführt. HINWEIS: Dies funktioniert derzeit nur unter Windows.
Typ: | PSSession[] |
Aliase: | Session |
Position: | 6 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Der Name der Ressourcengruppe, der Sie den Computer hinzufügen möchten.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SubscriptionId
Die ID des Abonnements, dem Sie den Computer hinzufügen möchten.
Typ: | String |
Position: | 2 |
Standardwert: | (Get-AzContext).Subscription.Id |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Tag
Ressourcentags.
Typ: | Hashtable |
Position: | 7 |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Azure PowerShell