Azure Arc 対応 Windows サーバーに Azure File Sync エージェント拡張機能をインストールして管理する

2025-06-21

この記事では、Azure Arc 対応 Windows サーバーに Azure File Sync エージェント拡張機能をインストール、検証、アンインストールする方法について説明します。 Azure File Sync Agent for Windows 拡張機能は、Azure Arc 経由で接続されている Windows サーバーに Azure File Sync エージェントをデプロイし、サーバーが Azure ファイル共有とファイルを同期できるようにします。拡張機能は Microsoft によって発行され、Azure portal、Azure PowerShell、または Azure CLI を使用して管理できます。

[前提条件]

Azure Arc 対応サーバー (Windows のみ): ターゲットマシンは、Azure Arc に接続し (Azure Connected Machine エージェントがインストールされ、オンボードが完了)、サポートされている Windows Server OS を実行する必要があります。 Azure File Sync は Windows Server 2012 R2 以降でサポートされています (サポートされているバージョンの詳細については、 Azure File Sync のシステム要件と相互運用性に関するページを参照してください)。

Von Bedeutung

Azure File Sync エージェント拡張機能は、 Windows でのみサポートされています。 Linux Arc 対応サーバーは、Azure File Sync ではサポートされていません。
Arc 対応サーバー には、Microsoft ルート証明書 (Microsoft ルート証明機関 2011) がインストールされている必要があります。詳細については、このドキュメントを参照してください。
Azure リソース: エージェントのインストール後にサーバーを登録するには、Azure サブスクリプションに Azure Storage Sync Service が存在する必要があります。 (インストール前にサーバーを登録する必要はありませんが、同期を開始するためにストレージ同期サービスに登録します。これについては、次の手順で説明します)。
Azure PowerShell または Azure CLI 環境:
- Azure PowerShell の場合は、Az.ConnectedMachine モジュールと共に Azure PowerShell モジュール (Az モジュール) をインストールします。最新の Az PowerShell がインストールされていることを確認し、 Connect-AzAccount 実行して Azure にサインインします。
- Azure CLI の場合は、Azure CLI をインストールしてサインインします (az login)。次を実行して、Azure CLI に Connected Machine 拡張機能がインストールされていることを確認します。
```
az extension add --name connectedmachine
```
  Connected Machine 拡張機能には、必要な az connectedmachine コマンドが用意されています。
ネットワーク接続: サーバーは、Azure Arc と Azure File Sync に必要な Azure エンドポイントへのネットワークアクセス権を持っている必要があります (たとえば、拡張機能をダウンロードして Azure File Sync サービスエンドポイントに到達するため)。ファイアウォールまたはプロキシの設定で、必要な Azure サービス URL が許可されていることを確認します。詳細については、 Azure File Sync のプロキシとファイアウォールの設定に関するページを参照してください。

エージェント拡張機能をインストールする

Azure Portal、Azure PowerShell、または Azure CLI を使用して、Arc 対応 Windows サーバーに Azure File Sync Agent for Windows 拡張機能をインストールできます。

Arc 対応サーバーリソースを開きます。 Azure portal で Azure Arc > Machines に移動し、拡張機能をインストールする Arc 対応 Windows サーバーを選択します。
拡張機能の追加: サーバーの [拡張機能 ] セクションで、[ + 追加] を選択します。使用可能な拡張機能の一覧で、 Windows 用 Azure File Sync Agent 拡張機能 ( Microsoft によって公開) を見つけて選択し、[ 次へ] を選択します。

Windows 用 Azure File Sync エージェント拡張機能をインストールする方法を示すスクリーンショット

設定の構成: Arc マシンにインストールされる Azure File Sync エージェントの設定を構成します。設定とその意味の完全な一覧については、「使用可能な設定」を参照してください。

Windows 用の Azure File Sync エージェント拡張機能を構成する方法を示すスクリーンショット

取り付ける： [ 確認と作成 ] を選択して拡張機能をデプロイします。 Azure は、最新バージョンの Azure File Sync エージェントをサーバーにインストールする拡張機能のインストールを開始します。数分以内に拡張機能をインストールする必要があります。デプロイの進行状況は、Azure portal で監視できます。完了すると、拡張機能が表示され、状態が [拡張機能] の一覧に [ プロビジョニングに成功しました ] と表示されます。

New-AzConnectedMachineExtension コマンドレットを使用して、Arc 対応 Windows サーバーに拡張機能をインストールします。次の例では、指定したコンピューターに拡張機能をインストールします。プレースホルダーをリソース名に置き換えます。 settings パラメーターに追加できる設定の完全な一覧については、「使用可能な設定」を参照してください。

プロキシ設定を使用しない Azure File Sync 拡張機能のインストール

$Settings = @{
  EnableAgentAutoUpdate = "true"
  AutoUpdateScheduledDayOfWeek = "Monday"
  AutoUpdateScheduledHourOfDay = 05
  EnableServerDiagnostics = "true"
  AgentInstallDir = "C:\Custom Path\AFS"
  EnrollInMicrosoftUpdate = "true"
}

New-AzConnectedMachineExtension `
  -ResourceGroupName <resource-group-name> `
  -MachineName <machine-name> `
  -Name AzureFileSyncExtension `
  -SubscriptionId <subscriptionId> `
  -Location <region> `
  -TypeHandlerVersion <version> `
  -Publisher Microsoft.StorageSync `
  -ExtensionType AzureFileSyncExtension `
  -Settings $settings

プロキシ設定を使用した Azure File Sync 拡張機能のインストール

$Settings = @{
  EnableAgentAutoUpdate = "true"
  AutoUpdateScheduledDayOfWeek = "Monday"
  AutoUpdateScheduledHourOfDay = 05
  EnableServerDiagnostics = "true"
  AgentInstallDir = "C:\Custom Path\AFS"
  EnrollInMicrosoftUpdate = "true"
  UseCustomProxy = "true"
  ProxyAddress = "http://proxy.contoso.com"
  ProxyPort = 1009
  ProxyAuthRequired = "true"
  ProxyUsername = "myuser"
}

$protectedSettings =@{
  ProxyPassword = "your_proxy_password"
}

New-AzConnectedMachineExtension `
  -ResourceGroupName <resource-group-name> `
  -MachineName <machine-name> `
  -Name AzureFileSyncExtension `
  -SubscriptionId <subscriptionId> `
  -Location <region> `
  -TypeHandlerVersion <version> `
  -Publisher Microsoft.StorageSync `
  -ExtensionType AzureFileSyncExtension `
  -Settings $settings `
  -ProtectedSetting $protectedSettings

az connectedmachine extension create コマンドを使用して、Azure CLI を使用して拡張機能をインストールします。次の例では、指定した Arc 対応サーバーに拡張機能をデプロイします。プレースホルダーを自分の情報に置き換え、必要に応じて値を変更します。設定の完全な一覧については、「使用可能な設定」を参照してください。

エージェントの設定を含む JSON ファイル (afs_settings.json) を作成します。

{
  "EnableAgentAutoUpdate": "true",
  "AutoUpdateScheduledDayOfWeek": "Monday",
  "AutoUpdateScheduledHourOfDay": 5,
  "EnableServerDiagnostics": "true",
  "AgentInstallDir": "C:\\Custom Path\\AFS",
  "EnrollInMicrosoftUpdate": "true",
  "UseCustomProxy": "true",
  "ProxyAddress": "http://proxy.contoso.com",
  "ProxyPort": 1009,
  "ProxyAuthRequired": "true",
  "ProxyUsername": "your_username"
}

保護された設定 (プロキシパスワードなど) を使用して、別のファイル (afs_pwd.json) を作成します。

{
  "ProxyPassword": "your_proxy_password"
}

次のコマンドを実行します。

az connectedmachine extension create \
  --name AzureFileSyncAgentExtension \
  --machine-name <machine> \
  --resource-group <machine rg> \
  --publisher Microsoft.StorageSync \
  --type AzureFileSyncAgentExtension \
  --settings "afs_settings.json" \
  --protected-settings "afs_pwd.json"

ARM テンプレートを使用してインストールする

Azure Resource Manager (ARM) テンプレートを使用して、Arc 対応 Windows サーバーに Azure File Sync エージェント拡張機能をデプロイすることもできます。この方法は、自動化または大規模なデプロイに役立ちます。

1. パラメーターファイルを準備する

VM 名や拡張機能の設定など、カスタマイズの詳細を含む parameters.json ファイルを作成します。

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "AgentInstallDir": { "value": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "UseCustomProxy": { "value": true },
    "ProxyAddress": { "value": "http://proxy.contoso.com" },
    "ProxyPort": { "value": "80" },
    "ProxyAuthRequired": { "value": true },
    "ProxyUserName": { "value": "ProxyUserName" },
    "ProxyPassword": { "value": "ProxyPassword" },
    "EnrollInMicrosoftUpdate": { "value": true },
    "EnableAgentAutoUpdate": { "value": true },
    "AutoUpdateScheduledDayOfWeek": { "value": "Monday" },
    "AutoUpdateScheduledHourOfDay": { "value": "23" },
    "EnableServerDiagnostics": { "value": true },
    "vmName": { "value": "ArcVM1" },
    "location": { "value": "eastus2euap" }
  }
}

2. テンプレートファイルを準備する

次に示すように、 template.json ファイルを作成します。このテンプレートでは、拡張機能リソースを定義し、パラメーターを拡張機能の設定にマップします。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "0.43.0.0",
  "parameters": {
    "vmName": { "type": "string" },
    "location": { "type": "string" },
    "agentInstallDir": { "type": "string", "defaultValue": "C:\\Program Files\\Azure\\StorageSyncAgent\\" },
    "useCustomProxy": { "type": "bool", "defaultValue": false },
    "proxyAddress": { "type": "string", "defaultValue": "" },
    "proxyPort": { "type": "string", "defaultValue": "0" },
    "proxyAuthRequired": { "type": "bool", "defaultValue": false },
    "proxyUsername": { "type": "string", "defaultValue": "" },
    "proxyPassword": { "type": "securestring", "defaultValue": "" },
    "enrollInMicrosoftUpdate": { "type": "bool", "defaultValue": true },
    "enableAgentAutoUpdate": { "type": "bool", "defaultValue": false },
    "autoUpdateScheduledDayOfWeek": { "type": "string", "defaultValue": "Tuesday" },
    "autoUpdateScheduledHourOfDay": { "type": "string", "defaultValue": "18" },
    "enableServerDiagnostics": { "type": "bool", "defaultValue": true }
  },
  "variables": {
    "AgentInstallDir": "[parameters('agentInstallDir')]",
    "UseCustomProxy": "[parameters('useCustomProxy')]",
    "ProxyAddress": "[parameters('proxyAddress')]",
    "ProxyPort": "[int(parameters('proxyPort'))]",
    "ProxyAuthRequired": "[parameters('proxyAuthRequired')]",
    "ProxyUserName": "[parameters('proxyUserName')]",
    "ProxyPassword": "[parameters('proxyPassword')]",
    "EnrollInMicrosoftUpdate": "[parameters('enrollInMicrosoftUpdate')]",
    "EnableAgentAutoUpdate": "[parameters('enableAgentAutoUpdate')]",
    "AutoUpdateScheduledDayOfWeek": "[parameters('autoUpdateScheduledDayOfWeek')]",
    "AutoUpdateScheduledHourOfDay": "[parameters('autoUpdateScheduledHourOfDay')]",
    "EnableServerDiagnostics": "[parameters('enableServerDiagnostics')]"
  },
  "resources": [
    {
      "name": "[concat(parameters('vmName'),'/AzureFileSyncAgentExtension')]",
      "type": "Microsoft.HybridCompute/machines/extensions",
      "location": "[parameters('location')]",
      "apiVersion": "2021-05-20",
      "properties": {
        "publisher": "Microsoft.StorageSync",
        "type": "AzureFileSyncAgentExtension",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": {
          "agentInstallDir": "[variables('AgentInstallDir')]",
          "useCustomProxy": "[variables('UseCustomProxy')]",
          "proxyAddress": "[variables('ProxyAddress')]",
          "proxyPort": "[variables('ProxyPort')]",
          "proxyAuthRequired": "[variables('ProxyAuthRequired')]",
          "proxyUsername": "[variables('ProxyUserName')]",
          "enrollInMicrosoftUpdate": "[variables('EnrollInMicrosoftUpdate')]",
          "enableAgentAutoUpdate": "[variables('EnableAgentAutoUpdate')]",
          "autoUpdateScheduledDayOfWeek": "[variables('AutoUpdateScheduledDayOfWeek')]",
          "autoUpdateScheduledHourOfDay": "[variables('AutoUpdateScheduledHourOfDay')]",
          "enableServerDiagnostics": "[variables('EnableServerDiagnostics')]"
        },
        "protectedSettings": {
          "proxyPassword": "[parameters('proxyPassword')]"
        }
      }
    }
  ]
}

3. テンプレートをデプロイする

次の PowerShell コマンドを使用して、テンプレートをリソースグループにデプロイします。

New-AzResourceGroupDeployment -ResourceGroupName "<ResourceGroupName>" -TemplateFile "template.json" -TemplateParameterFile "parameters.json"

<ResourceGroupName>を、Arc 対応マシンを含むリソースグループの名前に置き換えます。これにより、指定した設定で Azure File Sync エージェント拡張機能がターゲットの Arc 対応 Windows サーバーにデプロイされます。

使用可能な設定

Azure File Sync エージェント拡張機能のインストール中に、次の設定を構成できます。

名前	目的	値の種類/オプション	既定値
`AgentInstallDir`	Azure File Sync エージェントをインストールするディレクトリ	ファイルパス	`C:\Program Files\Azure\StorageSyncAgent\`
`EnableAgentAutoUpdate`	最新のエージェント更新プログラムを自動的にインストールする	`true` / `false`	`false`
`AutoUpdateScheduledDayOfWeek`	自動更新をスケジュールする曜日	`Sunday` から `Saturday` まで	`Tuesday`
`AutoUpdateScheduledHourOfDay`	スケジュールされた自動更新の 1 日の時間	`0`から`23`まで (24時間形式)	`18` (午後 6 時)
`EnableServerDiagnostics`	エージェント診断ログを有効または無効にする	`true` / `false`	`true`
`EnrollInMicrosoftUpdate`	Microsoft Update サービスに登録する	`true` / `false`	`true`
`UseCustomProxy`	接続にカスタムプロキシサーバーを使用する	`true` / `false`	`false`
`ProxyAddress`	カスタムプロキシサーバーのアドレス	URL または IP アドレス (例: `http://proxy.example.com` または https://192.168.1.1)	( `UseCustomProxy`* が `true`されている場合は必須)*
`ProxyPort`	プロキシサーバー通信用のポート	ポート番号 (例: `8080`)	( `UseCustomProxy`* が `true`されている場合は必須)*
`ProxyAuthRequired`	プロキシで認証が必要かどうかを示します	`true` / `false`	`false`
`ProxyUserName`	プロキシ認証のユーザー名	ユーザー名文字列	( `ProxyAuthRequired`* が `true`されている場合は必須)*
`ProxyPassword`	プロキシ認証のパスワード	パスワード文字列	( `ProxyAuthRequired`* が `true`されている場合は必須)*

Azure Arc マシンに Azure File Sync エージェントが既にインストールされている場合、拡張機能は正常にインストールされ、マシンにインストールされている既存の Azure File Sync エージェントは変更されません。

インストールの検証

インストール後、Azure File Sync エージェント拡張機能が正常にデプロイされていること、およびエージェントがサーバー上で実行されていることを確認します。

Azure portal で、Arc 対応サーバーリソースに移動し、[ 拡張機能 ] ブレードを開きます。 Azure File Sync エージェント拡張機能が一覧表示され、 その状態 が [成功] と表示されていることを確認します。拡張機能をクリックすると、バージョン番号やステータスメッセージなどの詳細を表示できます。さらに、サーバー自体で、 Azure File Sync エージェント がインストールされていることを確認できます (たとえば、[ プログラムと機能 ] をオンにするか、 FileSyncSvc サービスが実行されていることを確認します)。

Azure PowerShell を使用して、拡張機能がインストールされ、正常な状態であることを確認できます。

Get-AzConnectedMachineExtensionを使用して、コンピューター上の拡張機能を一覧表示または取得します。

Get-AzConnectedMachineExtension `
  -ResourceGroupName <resource-group-name> `
  -MachineName <machine-name> `
  -Name <EXTENSION_NAME>

Azure CLI を使用して、拡張機能がインストールされ、正常な状態であることを確認できます。

az connectedmachine extension showを使用して、インストールされている拡張機能の詳細を取得します。

az connectedmachine extension show \
  --resource-group "<resource-group-name>" \
  --machine-name "<machine-name>" \
  --name "<EXTENSION_NAME>"

出力には、 拡張機能 に関する情報 (エージェントが正しくインストールされている場合は成功する必要があります)、 Type (拡張機能の種類名)、 typeHandlerVersion (インストールされた Azure File Sync エージェントのバージョンを示す) など、拡張機能に関する情報が含まれます。プロビジョニング状態が成功し、報告されたバージョンが予想されるエージェントのバージョンと一致することを確認します。拡張機能がリストに表示されていない場合や、状態が成功したと表示されていない場合は、出力または Azure ポータルでエラーの詳細を確認してトラブルシューティングしてください。

次のステップ

拡張機能をインストールした後、Azure File Sync エージェントを Arc マシンにインストールする必要があります。ただし、マシンで Azure File Sync を有効にするには、次の手順を実行する必要があります。

Azure File Sync にサーバーを登録します。 エージェントのインストールは、最初の手順にすぎません。ファイルの同期を開始するには、 Windows Server を Azure Storage Sync サービス に登録して、サーバーと Azure File Sync の間の信頼を確立する必要があります。 Azure File Sync を使用した登録済みサーバーの管理 (サーバーの登録/登録解除) に関するページの手順に従って、サーバーをまだ登録していない場合は、サーバーを登録します。
同期グループとクラウドエンドポイントを作成します。 登録後、ストレージ同期サービスに 同期グループ を作成します。同期グループは、Azure ファイル共有 (クラウドエンドポイント) と登録済みサーバー (サーバーエンドポイント) 上のフォルダーをリンクします。ストレージ同期サービスの設定、同期グループの作成、サーバーエンドポイントの追加に関するエンドツーエンドガイドについては、 Azure File Sync をデプロイする方法に関するページを参照してください。
詳細情報とトラブルシューティング: 詳細については、 Azure File Sync デプロイの計画に関するページを参照して、要件とベストプラクティスを理解してください。インストールまたはサーバーの登録中に問題が発生した場合は、一般的な問題と解決策については、 Azure File Sync エージェントのインストールと登録のトラブルシューティングを参照してください。

エージェント拡張機能をアンインストールする

特定の Arc 対応サーバーで Azure File Sync エージェント拡張機能が不要になった場合は、Azure portal、Azure PowerShell、または Azure CLI を使用して拡張機能をアンインストールできます。拡張機能をアンインストールすると、Azure File Sync エージェントはサーバーから削除 されません 。

Azure File Sync エージェントを削除すると、そのサーバー上のクラウド同期が停止します。 サーバーが現在ストレージ同期サービスに登録されていて、同期グループに参加している場合、エージェントをアンインストールすると、同期接続とファイル同期トポロジが切断されます。 Arc マシン上のエージェントを削除する場合は、Azure File Sync エージェントのアンインストールに関する詳細な手順について、 プロビジョニング解除または Azure File Sync サーバーエンドポイントの削除 を確認してください。

Azure Portal を使用して Azure File Sync エージェント拡張機能をアンインストールするには:

Azure portal で Arc 対応サーバーに移動し、[ 拡張機能とアプリケーション ] セクションを開きます。
インストールされている拡張機能の一覧で、Azure File Sync エージェントの拡張機能を見つけます。拡張機能を選択して詳細を開きます。
アンインストール (または拡張機能の削除) を選択し、拡張機能を削除するプロンプトを確認します。 Azure は拡張機能をマシンからアンインストールします。
拡張機能が削除されるまで待ちます。アンインストールが完了すると、拡張機能のエントリは拡張機能の一覧から消えます。 Windows サーバーでは、このプロセスの一環として Azure File Sync エージェントソフトウェアが自動的にアンインストールされます。

Remove-AzConnectedMachineExtension コマンドレットを使用して、Arc 対応サーバーから拡張機能をアンインストールします。

Remove-AzConnectedMachineExtension `
  -MachineName <machine-name> `
  -ResourceGroupName <resource-group-name> `
  -Name <EXTENSION_NAME>

このコマンドを実行すると、Azure File Sync エージェント拡張機能の削除が開始されます。成功すると、拡張機能は Azure に登録解除され、拡張機能を使用して Azure File Sync エージェントを管理できなくなります。

az connectedmachine extension deleteを使用して、Arc 対応サーバーから拡張機能を削除します。

az connectedmachine extension delete \
  --machine-name "<machine-name>" \
  --resource-group "<resource-group-name>" \
  --name "<EXTENSION_NAME>"

削除を確認するには、Azure portal で 拡張機能 の一覧を確認するか (拡張機能が表示されなくなります)、上記の検証コマンドを実行します (拡張機能が見つからないはずです)。拡張機能のアンインストールに失敗した場合は、Azure アクティビティログまたは拡張機能インスタンスビューでエラーの詳細を確認してください。