Get-SCSMClassInstance

Modul:

System.Center.Service.Manager

Získá instance třídy.

Syntax

Get-SCSMClassInstance
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMClassInstance
   [-Class] <ManagementPackClass[]>
   [[-Filter] <String>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMClassInstance
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMClassInstance
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMClassInstance
   [-Group] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMClassInstance
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-SCSMClassInstance
   [-Criteria] <EnterpriseManagementObjectCriteria>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

Rutina Get-SCSMClassInstance načte instance tříd.

Příklady

Příklad 1: Získání počítačů podle názvu NetBIOS

PS C:\>$MP = Get-SCManagementPack -name "Microsoft.Windows.Library"
PS C:\>$CriteriaFormat = '<Criteria 
>> xmlns="http://Microsoft.EnterpriseManagement.Core.Criteria/"><Reference 
>> Id="Microsoft.Windows.Library" Version="{0}" PublicKeyToken="{1}" 
>> Alias="myMP" 
>>/><Expression><SimpleExpression><ValueExpressionLeft><Property>$Target/Property[Type="myMP!Microsoft.Windows.Computer"]/NetbiosDomainName$</Property></ValueExpressionLeft><Operator>Equal</Operator><ValueExpressionRight><Value>IR2</Value></ValueExpressionRight></SimpleExpression></Expression></Criteria>'
PS C:\>$CriteriaType = "Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria"
PS C:\>$criteriaString = $criteriaFormat -f $MP.Version, $MP.KeyToken
PS C:\>$class = Get-SCClass -name "microsoft.windows.computer"
PS C:\>$criteria = new-object $CriteriaType $CriteriaString,$class,$class.ManagementGroup
PS C:\>Get-SCSMClassInstance -criteria $criteria

Tyto příkazy načítají počítače pomocí kritérií NetbiosDomainName se rovná WOODGROVE. První příkazy definují parametry, které se pak použijí v konečné rutině Get-SCSMClassInstance .

Příklad 2: Získání instancí tříd pomocí filtru

PS C:\>Get-SCSMClassInstance -class $class -filter 'NetbiosDomainName -eq "WOODGROVE"'
PrincipalName                 ObjectStatus ActiveDirectorySite     NetBiosDomainName
-------------                 ------------ -------------------     -----------------
WIN-752HJBSX24M.woodgrove.com Active       Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com        Active                               WOODGROVE

Tento příkaz načte objekty instance třídy z databáze Service Manager pomocí filtru. Všimněte si, že název vlastnosti ve filtru musí být přesný název vlastnosti a že se rozlišují malá a velká písmena.

Příklad 3: Získání všech objektů počítače

PS C:\>$class = Get-SCSMClass -name microsoft.windows.computer
PS C:\>Get-SCSMClassInstance -class $class|format-table PrincipalName,ObjectStatus,ActiveDirectorySite,NetbiosDomainName
PrincipalName                 ObjectStatus ActiveDirectorySite     NetbiosDomainName
-------------                 ------------ -------------------     -----------------
WIN-752HJBSX24M.woodgrove.com Active       Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com        Active                               WOODGROVE

Tento příkaz načte všechny objekty instance třídy typu Počítač z databáze Service Manager.

Parametry

-Class

Určuje název jedné nebo více tříd, které se mají načíst. Můžete zadat objekt ManagementPackClass , který je vrácen rutinou Get-SCClass .

Type:	Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Určuje počítač, se kterým se má vytvořit připojení. Počítač musí být spuštěný ve službě System Center Data Access. Výchozí hodnota je počítač pro aktuální připojení skupiny pro správu.

Platné formáty zahrnují název netBIOS, IP adresu nebo plně kvalifikovaný název domény (FQDN). Pokud chcete zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).

Type:	System.String[]
Position:	Named
Default value:	Localhost
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Určuje uživatelský účet, pod kterým se spustí připojení skupiny pro správu. Pokud je zadaný server, musí mít účet přístup k serveru zadanému v parametru ComputerName . Výchozí hodnota je aktuální uživatel.

Můžete zadat objekt PSCredential , který je vrácen rutinou Get-Credential .

Type:	System.Management.Automation.PSCredential
Position:	Named
Default value:	Current user context
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Criteria

Určuje objekt kritérií, který omezuje sadu instancí tříd vrácených ze serveru pro správu.

Type:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Určuje zobrazovaný název instance třídy, která se má načíst.

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

-Filter

Filtruje sadu výsledků. Syntaxe filtru je <hodnota> operátoru <vlastnosti>, kde platné operátory jsou -eq, -ne, -gt, -ge, -lt, -le, -like a -notlike. Použití filtru je efektivní, protože filtr omezuje výsledky načtené ze serveru pro správu místo toho, aby se po vrácení výsledků vrátily do PowerShellu.

Type:	System.String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Group

Určuje instanci skupiny, která obsahuje instance tříd, které se mají načíst.

Type:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

Určuje ID instancí třídy, které se mají načíst. Může se jednat o identifikátor GUID nebo řetězec, který se převede na identifikátor GUID.

Type:	System.Guid[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Určuje název instancí třídy, které se mají načíst.

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

-SCSession

Určuje připojení k serveru pro správu. Výchozí hodnota je aktuální připojení skupiny pro správu.

Můžete zadat objekt připojení skupiny pro správu, který je vrácen rutinou Get-SCManagementGroupConnection .

Type:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Třídu můžete řadit do parametru Třídy rutiny Get-SCSMClassInstance .

Výstupy

EnterpriseManagementObject

Tato rutina generuje objekt EnterpriseManagementObject#<classtype> .

Související odkazy

• New-SCSMClassInstance
• Remove-SCSMClassInstance
• Update-SCSMClassInstance