Udostępnij za pośrednictwem

Get-AzEventGridDomainTopic

  • Odwołanie
Moduł:
Az.EventGrid

Pobiera szczegóły tematu domeny usługi Event Grid lub pobiera listę wszystkich tematów domeny usługi Event Grid w ramach określonej domeny usługi Event Grid w bieżącej subskrypcji platformy Azure.

Składnia

Get-AzEventGridDomainTopic
   [-ResourceGroupName] <String>
   [-DomainName] <String>
   [-Name <String>]
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzEventGridDomainTopic
   [-ResourceId] <String>
   [-ODataQuery <String>]
   [-Top <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzEventGridDomainTopic
   [-NextLink <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzEventGridDomainTopic pobiera szczegóły określonego tematu domeny usługi Event Grid lub listę wszystkich tematów domeny usługi Event Grid w ramach określonej domeny w bieżącej subskrypcji platformy Azure. Jeśli zostanie podana nazwa tematu domeny, zostaną zwrócone szczegóły pojedynczego tematu domeny usługi Event Grid. Jeśli nazwa tematu domeny nie zostanie podana, zostanie zwrócona lista tematów domeny w ramach określonej nazwy domeny. Liczba elementów zwracanych na tej liście jest kontrolowana przez parametr Top. Jeśli nie określono wartości Top lub $null, lista będzie zawierać wszystkie elementy tematów domeny. W przeciwnym razie górna część będzie wskazywać maksymalną liczbę elementów, które mają być zwracane na liście. Jeśli więcej tematów domeny jest nadal dostępnych, wartość w aplikacji NextLink powinna być używana w następnym wywołaniu, aby uzyskać następną stronę tematów domeny. Na koniec parametr ODataQuery służy do filtrowania wyników wyszukiwania. Zapytanie filtrowania jest zgodne ze składnią OData tylko przy użyciu właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

Przykłady

Przykład 1

Pobiera szczegóły tematu domeny usługi Event Grid "DomainTopic1" w domenie usługi Event Grid "Domain1" w grupie zasobów "MyResourceGroupName".

Get-AzEventGridDomainTopic -ResourceGroup MyResourceGroupName -DomainName Domain1 -DomainTopicName DomainTopic1

ResourceGroupName : MyResourceGroupName
DomainName        : DomainTopic1
DomainTopicName   : Topic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Przykład 2

Pobiera szczegóły tematu domeny usługi Event Grid "DomainTopic1" w domenie usługi Event Grid "Domain1" w grupie zasobów "MyResourceGroupName" przy użyciu opcji ResourceId.

Get-AzEventGridDomainTopic -ResourceId "/subscriptions/$subscriptionId/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1"

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Przykład 3

Wyświetl listę wszystkich tematów domeny usługi Event Grid w domenie usługi Event Grid "Domain1" w grupie zasobów "MyResourceGroupName" bez stronicowania (wszystkie wyniki są zwracane w jednym zastrzeleniu).

$result=Get-AzEventGridDomainTopic -ResourceGroup MyResourceGroupName -DomainName Domain1
Write-Output $result.PsDomainTopicsList

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic2
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic2
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic3
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic3
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Przykład 4

Wyświetl listę wszystkich tematów domeny usługi Event Grid w domenie usługi Event Grid "Domain1" w grupie zasobów "MyResourceGroupName" bez stronicowania (wszystkie wyniki są zwracane w jednym zdjęciu) przy użyciu opcji ResourceId

$result=Get-AzEventGridDomainTopic -ResourceId "/subscriptions/$subscriptionId/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1"
Write-Output $result.PsDomainTopicsList

ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic1
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic1
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic2
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic2
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded


ResourceGroupName : MyResourceGroupName
DomainName        : Domain1
DomainTopicName   : DomainTopic3
Id                : /subscriptions/20902276-e53b-4421-8565-f57bcad74f6e/resourceGroups/MyResourceGroupName/providers/Microsoft.EventGrid/domains/Domain1/topics/DomainTopic3
Type              : Microsoft.EventGrid/domains/topics
ProvisioningState : Succeeded

Przykład 5

Wyświetl listę tematów domeny usługi Event Grid (jeśli istnieją) w domenie "Domain1" w grupie zasobów "MyResourceGroupName", która spełnia $odataFilter zapytania 10 tematów domeny naraz. Jeśli dostępnych jest więcej wyników, $result. Usługa NextLink nie będzie $null. Aby uzyskać kolejne strony tematów domeny, użytkownik powinien ponownie wywołać polecenie Get-AzEventGridDomainTopic i użyje wyniku. NextLink uzyskany z poprzedniego wywołania. Obiekt wywołujący powinien zatrzymać się, gdy wynik. Polecenie NextLink staje się $null.

$total = 0
$odataFilter = "Name ne 'ABCD'"
$result = Get-AzEventGridDomainTopic -ResourceGroup MyResourceGroupName -DomainName Domain1 -Top 10 -ODataQuery $odataFilter
$total += $result.Count
while ($result.NextLink -ne $Null)
    {
        $result = Get-AzEventGridDomainTopic -NextLink $result.NextLink
        $total += $result.Count
    }

Write-Output "Total number of domain topics is $Total"

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainName

EventGrid nazwa domeny.

Type:String
Aliases:Domain
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

EventGrid nazwa tematu domeny.

Type:String
Aliases:DomainTopicName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NextLink

Link do następnej strony zasobów, które mają zostać uzyskane. Ta wartość jest uzyskiwana przy użyciu pierwszego wywołania polecenia cmdlet Get-AzEventGrid, gdy więcej zasobów jest nadal dostępnych do odpytowania.

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

-ODataQuery

Zapytanie OData używane do filtrowania wyników listy. Filtrowanie jest obecnie dozwolone tylko dla właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

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

-ResourceGroupName

Nazwa grupy zasobów.

Type:String
Aliases:ResourceGroup
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Identyfikator zasobu reprezentujący domenę usługi Event Grid lub temat domeny siatki.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Top

Zapytanie OData używane do filtrowania wyników listy. Filtrowanie jest obecnie dozwolone tylko dla właściwości Name. Obsługiwane operacje obejmują: CONTAINS, eq (for equal), ne (for not equal), AND, OR i NOT.

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

Dane wejściowe

String

Int32

Dane wyjściowe

PSDomainTopic

PSDomainTopicListInstance