此套件包含一個同構的 SDK(可在 Node.js 與瀏覽器中執行),用於 MicrosoftSerialConsole 用戶端Azure。
Azure 序列主控台允許你存取虛擬機或虛擬機擴展集實例的串列主控台
主要連結:
入門指南
目前支援的環境
- Node.js的 LTS 版本
- 最新版的 Safari、Chrome、Edge 和 Firefox。
如需詳細資訊,請參閱我們的支援原則。
先決條件
安裝 @azure/arm-serialconsole 套件
安裝 Azure MicrosoftSerialConsole 用戶端函式庫,搭配 npm:
npm install @azure/arm-serialconsole
建立和驗證 MicrosoftSerialConsoleClient
要建立客戶端物件以存取 Azure MicrosoftSerialConsole API,你需要 Azure MicrosoftSerialConsole 資源的 endpoint 以及一個 credential。 Azure MicrosoftSerialConsole 客戶端可以使用 Azure Active Directory 憑證來認證。
你可以在
你可以用
若要使用下方所示的 DefaultAzureCredential 提供者,或Azure SDK附帶的其他憑證提供者,請安裝 @azure/identity 套件:
npm install @azure/identity
你還需要註冊一個新的 AAD 應用程式,並透過指派適當的角色給你的服務主體,授予 MicrosoftSerialConsole Azure的存取權(注意:像 "Owner" 這類角色不會授予必要的權限)。
想了解更多如何建立 Azure AD 應用程式的資訊,請參考 此指南。
使用 Node.js 和類似節點的環境,您可以使用 DefaultAzureCredential 類別來驗證用戶端。
import { MicrosoftSerialConsoleClient } from "@azure/arm-serialconsole";
import { DefaultAzureCredential } from "@azure/identity";
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new MicrosoftSerialConsoleClient(new DefaultAzureCredential(), subscriptionId);
針對瀏覽器環境,請使用來自 InteractiveBrowserCredential 套件的 @azure/identity 進行驗證。
import { InteractiveBrowserCredential } from "@azure/identity";
import { MicrosoftSerialConsoleClient } from "@azure/arm-serialconsole";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new MicrosoftSerialConsoleClient(credential, subscriptionId);
JavaScript 套件組合
若要在瀏覽器中使用此用戶端連結庫,您必須先使用配套程式。 如需如何執行這項操作的詳細資訊,請參閱我們的 組合檔。
關鍵概念
MicrosoftSerialConsoleClient
MicrosoftSerialConsoleClient 是開發者使用 Azure MicrosoftSerialConsole 用戶端函式庫的主要介面。 探索此用戶端物件的方法,以了解您可以存取的 Azure MicrosoftSerialConsole 服務的不同功能。
Troubleshooting
Logging
啟用記錄可能有助於找出有關失敗的實用資訊。 若要查看 HTTP 要求和回應的記錄,請將 AZURE_LOG_LEVEL 環境變數設定為 info。 或者,您可以在運行時間啟用記錄,方法是在 setLogLevel中呼叫 @azure/logger:
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
如需如何啟用記錄的詳細指示,請參閱
下一步
如需如何使用此連結庫的詳細範例,請參閱 範例 目錄。
Contributing
如果您想要參與此連結庫,請閱讀 參與指南,以深入瞭解如何建置和測試程序代碼。
相關專案
Microsoft JavaScript