Connect-AzConnectedMachine

  • リファレンス
モジュール:
Az.ConnectedMachine

新しいマシンを登録し、追跡対象のリソースを ARM に作成するための API

構文

Connect-AzConnectedMachine
       [-ResourceGroupName] <String>
       [[-SubscriptionId] <String>]
       [[-Name] <String>]
       [-Location] <String>
       [[-PSSession] <PSSession[]>]
       [[-Tag] <Hashtable>]
       [[-DefaultProfile] <PSObject>]
       [[-Proxy] <Uri>]
       [<CommonParameters>]

説明

新しいマシンを登録し、追跡対象のリソースを ARM に作成するための API

例

例 1: オンになっているマシンを接続済みマシンとしてオンボードする

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=978ab182-6cf0-4de3-a58b-53c8d0a3235e

Name             Location OSName   Status     ProvisioningState
----             -------- ------   ------     -----------------
linux_eastus1_1  eastus   linux    Connected  Succeeded

オンになっているマシンを接続されたマシンとしてオンボードします。

例 2: リモート コンピューターを接続済みデバイスとしてオンボードする

$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=978ab182-6cf0-4de3-a58b-53c8d0a3236a

Name           Location OSName   Status     ProvisioningState
----           -------- ------   ------     -----------------
win_eastus1_1  eastus   windows  Connected  Succeeded

PowerShell リモート処理を使用して、リモート コンピューターを接続されたデバイスとしてオンボードします。 注: 現時点では、ターゲットとしての Windows のみがサポートされています。

パラメーター

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

作成された ConnectedMachine の場所。

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

-Name

このマシンに使用される名前。 ホスト名は既定で使用されます。

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

-Proxy

使用するプロキシ サーバーの URI

Type:Uri
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PSSession

指定すると、マシンを Azure にオンボードするコマンドは、各 PSSession 内で実行されます。 注: これは、現時点では Windows でのみ機能します。

Type:PSSession[]
Aliases:Session
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

マシンを追加するリソース グループの名前。

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

-SubscriptionId

マシンを追加するサブスクリプションの ID。

Type:String
Position:2
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

リソース タグ。

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