Dela via


Get-CMUser

SYNOPSIS

Hämtar en Konfigurationshanteraren användare.

SYNTAX

ByName (standard)

Get-CMUser [-Name <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByIdMandatory

Get-CMUser -CollectionId <String> [-Name <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

SearchByNameMandatory

Get-CMUser -CollectionName <String> [-Name <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

SearchByValueMandatory

Get-CMUser -InputObject <IResultObject> [-Name <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

ById

Get-CMUser -ResourceId <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Cmdleten Get-CMUser hämtar ett Konfigurationshanteraren användarobjekt.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta en användare efter namn

PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\username01"

Det här kommandot hämtar användaren med namnet username01 från samlingen Alla användare.

Exempel 2: Skicka en samling och hämta en användare från den

PS XYZ:\> Get-CMCollection -Name "All Users" | Get-CMUser -Name "Contoso\testuser01"

Det här kommandot hämtar samlingsobjektet med namnet Alla användare och använder pipelineoperatorn för att skicka objektet till Get-CMUser, som hämtar användaren med namnet testuser01 från samlingsobjektet.

PARAMETERS

-CollectionId

Anger ID för en användarsamling.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Anger namnet på en användarsamling.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Anger ett samlingsobjekt. Om du vill hämta ett samlingsobjekt använder du cmdleten Get-CMCollection.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Collection

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Anger namnet på en användare.

Type: String
Parameter Sets: ByName, SearchByIdMandatory, SearchByNameMandatory, SearchByValueMandatory
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True

-ResourceId

Anger resurs-ID för en användare.

Type: Int32
Parameter Sets: ById
Aliases: Id, UserId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject[]#SMS_CombinedUserResources

IResultObject#SMS_CombinedUserResources

ANTECKNINGAR

Add-CMUserCollectionDirectMembershipRule

Get-CMCollection

Get-CMUserCollection

Remove-CMUser