Sdílet prostřednictvím

Get-MsolContact

  • Reference
Modul:
MSOnline

Získá kontakty z Azure Active Directory.

Syntaxe

Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolContact
   [-HasErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Rutina Get-MsolContact získá objekt kontaktu nebo seznam kontaktů. Zadáním parametru ObjectId získáte jeden kontakt.

Příklady

Příklad 1: Získání kontaktu

PS C:\> Get-MsolContact -ObjectId adc41dc7-4130-4215-adfb-2403bc9f844e

Tento příkaz načte kontakt.

Příklad 2: Získání kontaktů, které odpovídají řetězci

PS C:\> Get-MsolContact -SearchString "Patti"

Tento příkaz načte seznam kontaktů se zobrazovaným jménem nebo e-mailovou adresou začínající na Patti.

Parametry

-All

Označuje, že tato rutina vrátí všechny výsledky, které najde. Nezadávejte tento parametr a parametr MaxResults .

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HasErrorsOnly

Označuje, že tato rutina vrací kontakty s chybami ověřování.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxResults

Určuje maximální počet výsledků, které tato rutina vrátí. Výchozí hodnota je 500.

Typ:Int32
Position:Named
Default value:500
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ObjectId

Určuje jedinečné ID objektu kontaktu, který chcete získat.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SearchString

Určuje řetězec. Tato rutina vrátí kontakty se zobrazovaným jménem nebo e-mailovou adresou, které začínají tímto řetězcem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TenantId

Určuje jedinečné ID tenanta, na kterém se má operace provést. Výchozí hodnota je tenant aktuálního uživatele. Tento parametr platí jenom pro partnerské uživatele.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

Microsoft.Online.Administration.Contact

Tato rutina vrátí objekty kontaktů, které zahrnují následující informace:

  • Město. Město kontaktu.

  • Země. Země nebo oblast kontaktu.

  • Oddělení. Oddělení kontaktu.

  • Displayname. Zobrazované jméno kontaktu

  • Faxové. Faxové číslo kontaktu.

  • Jméno. Jméno kontaktu.

  • LastDirSyncTime. Vrátí datum a čas poslední synchronizace (vráceno pouze z kontaktů synchronizovaných se synchronizací služby Active Directory).

  • Lastname. Příjmení kontaktu

  • MobilePhone. Číslo mobilního telefonu kontaktu.

  • Objectid. Jedinečné ID kontaktu.

  • Office. Číslo kanceláře kontaktu.

  • Telefonní číslo. Telefonní číslo kontaktu.

  • Psč. Poštovní směrovací číslo kontaktu.

  • Adresy proxy serveru. Adresy proxy serveru přidružené k tomuto kontaktu.

  • Státu. Stav kontaktu.

  • Streetaddress. Adresa kontaktu.

  • Název. Název kontaktu.

  • Userprincipalname. ID uživatele kontaktu.

  • ValidationStatus. Určuje, jestli kontakt obsahuje nějaké chyby.