Utility 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
這個Utility類別代表一個工具控制點（UCP），定義了管理一個或多個遠端 SQL Server 實例的方法與屬性。
public ref class Utility sealed : Microsoft::SqlServer::Management::Sdk::Sfc::SfcInstance, Microsoft::SqlServer::Management::Common::IAlterable, Microsoft::SqlServer::Management::Sdk::Sfc::ISfcAlterable, Microsoft::SqlServer::Management::Sdk::Sfc::ISfcDomain2[Microsoft.SqlServer.Management.Facets.EvaluationMode(Microsoft.SqlServer.Management.Dmf.AutomatedPolicyEvaluationMode.CheckOnSchedule)]
[Microsoft.SqlServer.Management.Sdk.Sfc.LocalizedPropertyResources("Microsoft.SqlServer.Management.Utility.FacetSR", true)]
[Microsoft.SqlServer.Management.Sdk.Sfc.PhysicalFacet]
[System.ComponentModel.TypeConverter(typeof(Microsoft.SqlServer.Management.Sdk.Sfc.LocalizableTypeConverter))]
public sealed class Utility : Microsoft.SqlServer.Management.Sdk.Sfc.SfcInstance, Microsoft.SqlServer.Management.Common.IAlterable, Microsoft.SqlServer.Management.Sdk.Sfc.ISfcAlterable, Microsoft.SqlServer.Management.Sdk.Sfc.ISfcDomain2[<Microsoft.SqlServer.Management.Facets.EvaluationMode(Microsoft.SqlServer.Management.Dmf.AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
[<Microsoft.SqlServer.Management.Sdk.Sfc.LocalizedPropertyResources("Microsoft.SqlServer.Management.Utility.FacetSR", true)>]
[<Microsoft.SqlServer.Management.Sdk.Sfc.PhysicalFacet>]
[<System.ComponentModel.TypeConverter(typeof(Microsoft.SqlServer.Management.Sdk.Sfc.LocalizableTypeConverter))>]
type Utility = class
inherit SfcInstance
interface ISfcDomain2
interface ISfcDomain
interface ISfcDomainLite
interface ISfcHasConnection
interface ISfcAlterable
interface IAlterablePublic NotInheritable Class Utility
Inherits SfcInstance
Implements IAlterable, ISfcAlterable, ISfcDomain2- 繼承
- 屬性
- 實作
備註
SQL Server 的遠端實例，以類別實例表示ManagedInstance，可透過 ManagedInstanceFactory 類別定義的方法加入 SQL Server 工具的集合。 在登記後 Utility，這些個案尚未完全管理，直到其使用數據和健康狀況確定。
建構函式
| 名稱 | Description |
|---|---|
| Utility() |
初始化一個新的預設類別實例 Utility 。 |
| Utility(SqlStoreConnection) |
初始化一個與 的指定連結 |
屬性
| 名稱 | Description |
|---|---|
| AbstractIdentityKey |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| Computers |
取得執行受管理實例的電腦集合。 |
| CreatedBy |
取得建立該 Utility. 的使用者的認證憑證。 |
| DateCreated |
取得 SQL Server 工具建立的日期和時間。 |
| DeployedDacCount |
取得由 SQL Server 工具管理的 SQL Server 實例中已部署的 DAC 數量。 |
| DeployedDacHealthyCount |
取得由 SQL Server 工具管理的 SQL Server 實例中已部署的健康 DAC 數量。 |
| DeployedDacManagementPendingCount |
取得已部署且處於待處理管理狀態的 DAC 實例數量。 |
| DeployedDacOnOverutilizedComputerCount |
會取得部署在過度使用電腦上運行的管理實例上的 DAC 數量。 |
| DeployedDacOnUnderutilizedComputerCount |
取得部署在管理實例中、運行於未充分利用電腦上的 DAC 數量。 |
| DeployedDacOverutilizedCount |
會取得過度使用已部署的 DAC 數量。 |
| DeployedDacs |
取得部署在受管理實例上的 DAC 數量。 |
| DeployedDacUnderutilizedCount |
取得所有受管理實例中已部署且未充分利用的 DAC 數量。 |
| DeployedDacUnhealthyCount |
取得所有受管理實例部署的不健康 DAC 數量。 |
| DeployedDacWithFilesOnOverutilizedVolumeCount |
會取得部署中檔案存放於過度使用卷的 DAC 數量。 |
| DeployedDacWithFilesOnUnderutilizedVolumeCount |
取得部署中檔案存放於未充分利用磁碟區的 DAC 數量。 |
| DeployedDacWithOverutilizedFileCount |
會取得已部署且檔案過度使用的 DAC 數量。 |
| DeployedDacWithOverutilizedProcessorCount |
會顯示在過度使用處理器上運作的部署 DAC 數量。 |
| DeployedDacWithUnderutilizedFileCount |
會取得部署中檔案未充分利用的 DAC 數量。 |
| DeployedDacWithUnderutilizedProcessorCount |
會獲得在未充分利用處理器上運作的部署 DAC 數量。 |
| Description |
取得或設定描述 String UCP的 。 |
| ManagedInstanceCount |
取得由 UCP 管理的 SQL Server 實例數量。 |
| ManagedInstanceHealthyCount |
取得由 UCP 管理的健康 SQL Server 實例數量。 |
| ManagedInstanceManagementPendingCount |
取得持有待處理狀態的 SQL Server 實例數量。 |
| ManagedInstanceOnOverutilizedComputerCount |
取得在過度使用電腦上運行的 SQL Server 管理實例數量。 |
| ManagedInstanceOnUnderutilizedComputerCount |
取得在未充分利用電腦上運行的 SQL Server 管理實例數量。 |
| ManagedInstanceOverutilizedCount |
取得 SQL Server 過度使用的管理實例數量。 |
| ManagedInstances |
會取得包含由此Utility管理的每個 SQL Server 實例的集合。 |
| ManagedInstanceUnderutilizedCount |
取得未充分利用的 SQL Server 管理實例數量。 |
| ManagedInstanceUnhealthyCount |
取得 SQL Server 中不健康管理實例的數量。 |
| ManagedInstanceWithFilesOnOverutilizedVolumeCount |
取得有檔案存放於過度使用磁碟區的 SQL Server 管理實例數量。 |
| ManagedInstanceWithFilesOnUnderutilizedVolumeCount |
取得管理中檔案存放於未充分利用卷的 SQL Server 實例數量。 |
| ManagedInstanceWithOverutilizedFileCount |
取得管理中檔案過度使用的 SQL Server 實例數量。 |
| ManagedInstanceWithOverutilizedProcessorCount |
取得在過度使用處理器上執行的 SQL Server 管理實例數量。 |
| ManagedInstanceWithUnderutilizedFileCount |
取得管理中未充分利用檔案的 SQL Server 實例數量。 |
| ManagedInstanceWithUnderutilizedProcessorCount |
取得在未充分利用處理器上執行的 SQL Server 管理實例數量。 |
| MdwDatabaseName |
取得或設定公用事業管理資料倉儲（UMDW）資料庫的名稱。 |
| MdwRetentionLengthInDaysForDaysHistory |
取得或設定該資料在管理Data Warehouse（MDW）歷史表中保留的每日條目長度（以天數計）。 |
| MdwRetentionLengthInDaysForHoursHistory |
取得或設定公用事業管理資料倉儲（UMDW）歷史表中每小時條目資料保留的天數長度。 |
| MdwRetentionLengthInDaysForMinutesHistory |
取得或設定公用事業管理資料倉儲（UMDW）歷史表中每分鐘條目資料的天數長度。 |
| Metadata |
回傳關於實例及其網域的元資料。 (繼承來源 SfcInstance) |
| Name |
取得連接的 SQL Store 伺服器名稱。 |
| OverUtilizationOccurenceFrequency |
取得或設定用於電腦過度利用健康狀態的出現頻率，該頻率在指定的後期窗口內進行。 |
| OverUtilizationTrailingWindow |
取得或設定用來計算健康狀態的後續窗口（小時）。 |
| Parent |
透過鑰匙圈取得或設定實例父節點。 (繼承來源 SfcInstance) |
| PolicyStore |
取得 PolicyStore 定義 SQL Store 連線政策的物件。 |
| Properties |
回傳集合實例屬性。 (繼承來源 SfcInstance) |
| PropertyStorageProvider |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| SqlStoreConnection |
取得或設定 SQL Store 連線 |
| State |
回傳 SfcInstance 物件的狀態。 (繼承來源 SfcInstance) |
| TotalStorageCapacity |
取得公用事業的儲存容量。 |
| TotalStorageUtilization |
取得目前使用的 SQL Server 工具儲存空間。 |
| UnderUtilizationOccurenceFrequency |
取得或設定用於電腦在指定尾段期間未充分利用健康狀態的發生頻率。 |
| UnderUtilizationTrailingWindow |
取得或設定用來計算健康狀態的後續窗口（小時）。 |
| Urn |
回傳 SfcInstance 物件的統一資源名稱。 (繼承來源 SfcInstance) |
| UtilityName |
取得公用事業控制點（UCP）的名稱。 |
方法
| 名稱 | Description |
|---|---|
| Alter() |
更新 SQL Server 實例上的任何Utility屬性變更。 |
| AlterImpl() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| CheckObjectCreated() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| CheckObjectState() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| Connect(SqlStoreConnection) |
回傳 SqlStoreConnection 由 指定的 |
| CreateIdentityKey() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| CreateImpl() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| CreateUtility(String, SqlStoreConnection, String, SqlSecureString) |
建立 Utility 物件。 |
| CreateUtility(String, SqlStoreConnection) |
建立 Utility 物件。 |
| Discover(ISfcDependencyDiscoveryObjectSink) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| DropImpl() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| EnrollInstance(SqlStoreConnection, String, SqlSecureString) |
以參數提供的 |
| EnrollInstance(SqlStoreConnection) |
以參數提供的 |
| GetChildCollection(String) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| GetDomain() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| GetPropertySet() |
回傳 SfcInstance 物件的屬性集合。 (繼承來源 SfcInstance) |
| GetTypeMetadataImpl() |
直接回傳正確的 TypeMetadata 類別，表示覆蓋的網域。 請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| InitializeUIPropertyState() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| IsLoginUtilityReader(SqlStoreConnection) |
驗證連線中使用的登入是否具備工具讀取器角色。 |
| IsUtilityControlPoint(SqlStoreConnection) |
判斷指定伺服器是否為公用事業控制點（UCP）。 |
| MarkForDropImpl(Boolean) |
回傳一個表示已存在物件要丟棄的值。 請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| MarkRootAsConnected() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| MoveImpl(SfcInstance) |
表示在實例中要移動的新父物件。 請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| OnPropertyMetadataChanges(SfcPropertyMetadataChangedEventArgs) |
每當任何 SfcInstance 元資料的有效值更新時都會被調用。 (繼承來源 SfcInstance) |
| OnPropertyValueChanges(PropertyChangedEventArgs) |
每當任何 SfcInstance 屬性的有效值更新時都會被調用。 (繼承來源 SfcInstance) |
| PostAlter(Object) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| PostCreate(Object) |
表示產生執行結果的預設實作。 請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| PostDrop(Object) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| PostMove(Object) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| PostRename(Object) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| Refresh() |
刷新 SQL Server 工具屬性。 |
| RenameImpl(SfcKey) |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| ResetKey() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| ScriptAlter() |
如果基底物件被更改，則會改變其屬性。 |
| Serialize(XmlWriter) |
將實例序列化為 XML。 (繼承來源 SfcInstance) |
| ToString() |
回傳 urn 實例的字串表示。 (繼承來源 SfcInstance) |
| UpdateUIPropertyState() |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| Validate() |
表示基本子物件的驗證。 請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
事件
| 名稱 | Description |
|---|---|
| propertyChanged |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 (繼承來源 SfcInstance) |
| PropertyChanged |
發生於屬性值變更時。 (繼承來源 SfcInstance) |
| propertyMetadataChanged |
請勿在程式碼中直接提及此成員。 它支援 SQL Server 基礎架構。 當屬性元資料值改變時會發生。 (繼承來源 SfcInstance) |
| PropertyMetadataChanged |
當某個物業的元資料發生變化時。 (繼承來源 SfcInstance) |
明確介面實作
| 名稱 | Description |
|---|---|
| ISfcDomain.GetExecutionEngine() |
會有一個新的執行引擎介面。 |
| ISfcDomain.GetKey(IUrnFragment) |
拿到一個新 SfcKey 物件。 |
| ISfcDomain.GetType(String) |
取得 Type 公用事業。 |
| ISfcDomain.GetTypeMetadata(String) |
取得 SfcTypeMetadata。 |
| ISfcDomain.UseSfcStateManagement() |
傳回 |
| ISfcDomain2.GetUrnSkeletonsFromType(Type) |
會得到包含 URN 骨架的字串值清單。 |
| ISfcDomainLite.DomainInstanceName |
取得網域的實例名稱。 |
| ISfcDomainLite.DomainName |
取得網域名稱。 |
| ISfcDomainLite.GetLogicalVersion() |
會得到一個整數值，指定邏輯版本。 |
| ISfcHasConnection.ConnectionContext |
會取得連線的連線上下文模式。 |
| ISfcHasConnection.GetConnection() |
取得 ISfcConnection。 |
| ISfcHasConnection.GetConnection(SfcObjectQueryMode) |
取得 ISfcConnection。 |
| ISfcHasConnection.SetConnection(ISfcConnection) |
設定 ISfcConnection。 |