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.