語言

Utility 類別

定義

命名空間:
Microsoft.SqlServer.Management.Utility
組件:
Microsoft.SqlServer.Management.Utility.dll

這個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 IAlterable
Public NotInheritable Class Utility
Inherits SfcInstance
Implements IAlterable, ISfcAlterable, ISfcDomain2
繼承
Object
SfcInstance
Utility
屬性
EvaluationModeAttribute LocalizedPropertyResourcesAttribute PhysicalFacetAttribute TypeConverterAttribute
實作
IAlterable ISfcAlterable ISfcDomain ISfcDomain2 ISfcDomainLite ISfcHasConnection

備註

SQL Server 的遠端實例，以類別實例表示ManagedInstance，可透過 ManagedInstanceFactory 類別定義的方法加入 SQL Server 工具的集合。 在登記後 Utility，這些個案尚未完全管理，直到其使用數據和健康狀況確定。

建構函式

名稱 Description
Utility()

初始化一個新的預設類別實例 Utility 。
Utility(SqlStoreConnection)

初始化一個與 的指定連結SqlStore的類別新實例Utility。

屬性

名稱 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 由 指定的 connection物件。
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)

以參數提供的sqlStoreConnection連線註冊物件Utility。
EnrollInstance(SqlStoreConnection)

以參數提供的sqlStoreConnection連線註冊物件Utility。
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()

傳回 True。
ISfcDomain2.GetUrnSkeletonsFromType(Type)

會得到包含 URN 骨架的字串值清單。
ISfcDomainLite.DomainInstanceName

取得網域的實例名稱。
ISfcDomainLite.DomainName

取得網域名稱。
ISfcDomainLite.GetLogicalVersion()

會得到一個整數值，指定邏輯版本。
ISfcHasConnection.ConnectionContext

會取得連線的連線上下文模式。
ISfcHasConnection.GetConnection()

取得 ISfcConnection。
ISfcHasConnection.GetConnection(SfcObjectQueryMode)

取得 ISfcConnection。
ISfcHasConnection.SetConnection(ISfcConnection)

設定 ISfcConnection。

適用於