Get-SCSMClassInstance

Modul:

System.Center.Service.Manager

Hämtar klassinstanser.

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

Cmdleten Get-SCSMClassInstance hämtar klassinstanser.

Exempel

Exempel 1: Hämta datorer efter NetBIOS-namn

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

Dessa kommandon hämtar datorer med hjälp av kriterierna för NetbiosDomainName är lika med WOODGROVE-. De första kommandona definierar de parametrar som sedan används i den sista Get-SCSMClassInstance-cmdleten.

Exempel 2: Hämta klassinstanser med ett filter

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

Det här kommandot hämtar klassinstansobjekt från Service Manager-databasen med hjälp av ett filter. Observera att egenskapsnamnet i filtret måste vara det exakta namnet på egenskapen och att det är skiftlägeskänsligt.

Exempel 3: Hämta alla datorobjekt

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

Dessa kommandon hämtar alla klassinstansobjekt av typen Dator från Service Manager-databasen.

Parametrar

-Class

Anger namnet på en eller flera klasser som ska hämtas. Du kan ange ett ManagementPackClass- objekt som returneras av cmdleten Get-SCClass.

Typ:	Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ComputerName

Anger en dator att upprätta en anslutning till. Datorn måste köra System Center Data Access-tjänsten. Standardvärdet är datorn för den aktuella hanteringsgruppens anslutning.

Giltiga format innehåller ett NetBIOS-namn, en IP-adress eller ett fullständigt domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, "localhost" eller en punkt (.).

Typ:	System.String[]
Position:	Named
Standardvärde:	Localhost
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Credential

Anger ett användarkonto som hanteringsgruppens anslutning ska köras under. Kontot måste ha åtkomst till den server som anges i parametern ComputerName om servern har angetts. Standardvärdet är den aktuella användaren.

Du kan ange ett PSCredential- objekt som returneras av cmdleten Get-Credential.

Typ:	System.Management.Automation.PSCredential
Position:	Named
Standardvärde:	Current user context
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Criteria

Anger ett villkorsobjekt som begränsar uppsättningen klassinstanser som returneras från hanteringsservern.

Typ:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-DisplayName

Anger visningsnamnet för den klassinstans som ska hämtas.

Typ:	System.String[]
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Filter

Filtrerar resultatuppsättningen. Syntaxen för filtret är egenskapen <> operatorn <värdet>, där giltiga operatorer är -eq, -ne, -gt, -ge, -lt, -le, -like och -notlike. Att använda ett filter är effektivt eftersom filtret begränsar de resultat som hämtas från hanteringsservern i stället för att tillämpas när resultaten returneras till PowerShell.

Typ:	System.String
Position:	2
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Group

Anger en instans av en grupp som innehåller de klassinstanser som ska hämtas.

Typ:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Id

Anger ID för de klassinstanser som ska hämtas. Detta kan vara ett GUID eller en sträng som konverteras till ett GUID.

Typ:	System.Guid[]
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Anger namnet på de klassinstanser som ska hämtas.

Typ:	System.String[]
Position:	1
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-SCSession

Anger en anslutning till en hanteringsserver. Standardvärdet är den aktuella hanteringsgruppens anslutning.

Du kan ange ett hanteringsgruppanslutningsobjekt som returneras av cmdleten Get-SCManagementGroupConnection.

Typ:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Du kan skicka en klass till parametern Class i cmdleten Get-SCSMClassInstance.

Utdata

EnterpriseManagementObject

Den här cmdleten genererar ett EnterpriseManagementObject#<classtype>-objekt.

Relaterade länkar

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