Udostępnij za pośrednictwem


Get-MsolContact

Pobiera kontakty z usługi Azure Active Directory.

Składnia

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>]

Opis

Polecenie cmdlet Get-MsolContact pobiera obiekt kontaktu lub listę kontaktów. Określ parametr ObjectId , aby uzyskać jeden kontakt.

Przykłady

Przykład 1: Uzyskiwanie kontaktu

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

To polecenie pobiera kontakt.

Przykład 2. Pobieranie kontaktów pasujących do ciągu

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

To polecenie pobiera listę kontaktów z nazwą wyświetlaną lub adresem e-mail rozpoczynającym się od patti.

Parametry

-All

Wskazuje, że to polecenie cmdlet zwraca wszystkie znalezione wyniki. Nie należy określać tego parametru i parametru MaxResults .

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HasErrorsOnly

Wskazuje, że to polecenie cmdlet zwraca kontakty z błędami walidacji.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxResults

Określa maksymalną liczbę wyników zwracanych przez to polecenie cmdlet. Wartość domyślna to 500.

Typ:Int32
Position:Named
Domyślna wartość:500
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ObjectId

Określa unikatowy identyfikator obiektu kontaktu do pobrania.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SearchString

Określa ciąg. To polecenie cmdlet zwraca kontakty z nazwą wyświetlaną lub adresem e-mail rozpoczynającym się od tego ciągu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TenantId

Określa unikatowy identyfikator dzierżawy, w której ma być wykonywana operacja. Wartość domyślna to dzierżawa bieżącego użytkownika. Ten parametr ma zastosowanie tylko do użytkowników partnerów.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Microsoft.Online.Administration.Contact

To polecenie cmdlet zwraca obiekty kontaktu, które zawierają następujące informacje:

  • Miasta. Miasto kontaktu.

  • Kraju. Kraj lub region kontaktu.

  • Dział. Dział kontaktu.

  • Displayname. Nazwa wyświetlana kontaktu.

  • Faksu. Numer faksu kontaktu.

  • Imię. Imię kontaktu.

  • LastDirSyncTime. Zwraca datę i godzinę ostatniej synchronizacji (zwracane tylko z kontaktów zsynchronizowanych z synchronizacją usługi Active Directory).

  • Nazwisko. Nazwisko kontaktu.

  • Telefon komórkowy. Numer telefonu komórkowego kontaktu.

  • Objectid. Unikatowy identyfikator kontaktu.

  • Office. Numer biura kontaktu.

  • Numer telefonu. Numer telefonu kontaktu.

  • Kod pocztowy. Kod pocztowy kontaktu.

  • Adresy serwera proxy. Adresy serwera proxy skojarzone z tym kontaktem.

  • Państwa. Stan kontaktu.

  • Streetaddress. Adres ulicy kontaktu.

  • Tytuł. Tytuł kontaktu.

  • Userprincipalname. Identyfikator użytkownika kontaktu.

  • Validationstatus. Bez względu na to, czy kontakt ma jakiekolwiek błędy.